Improve your Skyline experience
You're using a browser that skyline.benevity.org does not support. Try Chrome, Edge, Safari or Firefox for a better experience.

# Get cause details

After you search for a cause, you may wish to obtain additional details about the cause — such as the cause's street address, social media links, or their full description.

# Building your request

You may get a cause's details by passing the exact value of their causeId in the /causes/{id} endpoint. In addition, ensure that your request has been authenticated by passing your JWT access_token as the Authorization header.

# Sample request:

In our example, we're going to be looking up additional details for the GlobalGiving Foundation, which has a causeId of 840-300108263.

# Sample response:

{
    "data": {
        "type": "causes",
        "id": "840-300108263",
        "attributes": {
            "name": "GlobalGiving Foundation",
            "government_name": "GLOBALGIVING FOUNDATION INC",
            "phone": "(202) 232-5784",
            "website": "http://www.globalgiving.org/",
            "social": {
                "facebook": "http://www.facebook.com/globalgiving",
                "twitter": "globalgiving",
                "rss": "http://feeds.feedburner.com/GlobalGivingProjects?format=xml"
            },
            "address": {
                "street": "1100 Vermont Ave NW",
                "line2": "Suite 550",
                "city": "Washington",
                "postcode": "20005",
                "region": {
                    "name": "District of Columbia",
                    "alpha_code": "DC"
                },
                "country": {
                    "numeric_code": "840",
                    "alpha_code": "USA",
                    "name": "United States"
                }
            },
            "caption": "GlobalGiving is a top-rated nonprofit that accelerates community-led change around the world. Since 2002, we’ve been on a mission to transform the way aid and philanthropy works for people in 170+ countries.",
            "description": "** NOTE: To donate to one of GlobalGiving's projects, please use the search feature above. By donating here—to GlobalGiving—you acknowledge that your donation is intended as general operating support for GlobalGiving, rather than a donation to one of our thousands of projects posted by vetted charities. We cannot guarantee any designations made through the donor note/comment feature will be disbursed to the intended recipient nonprofit or project. **\n\nGlobalGiving connects nonprofits, donors, and companies in nearly every country in the world. We help fellow nonprofits access the funding, tools, training, and support they need to serve their communities.\n\nGlobalGiving performs rigorous due diligence on every organization in the GlobalGiving community in order to ensure they are performing charitable work in a transparent and accountable manner, and that they meet local requirements for registration with their local government.\n\nFEES\nIt does cost money to vet, onboard, and support our nonprofit community—and enable donors to safely make online contributions—and we want to explain how we make it happen. GlobalGiving retains a 10% nonprofit support fee on donations made on this platform to our partner organizations. This allows us to fulfill our mission to support our partners with the best tools, training, and support.\n\nIn some cases, your employer may underwrite GlobalGiving's nonprofit support fee, so that 100% of your donation goes to the cause of your choice.",
            "active": true,
            "disbursable": true,
            "tags": [
                {
                    "type": "public",
                    "value": "disaster"
                },
                {
                    "type": "public",
                    "value": "crisis"
                },
                {
                    "type": "public",
                    "value": "foreign"
                }
            ],
            "categories": [
                {
                    "category_name": "International, Foreign Affairs, and National Security",
                    "category_code": "Q",
                    "subcategory_name": "Single Organization Support",
                    "subcategory_code": "11"
                }
            ],
            "certification": {
                "status": "certified",
                "effective_timestamp": "2022-04-29T17:32:14+00:00",
                "expiry_timestamp": "2023-04-29T17:32:14+00:00"
            },
            "claimed": "2021-07-23T13:20:35+00:00",
            "owner_verified": {
                "status": true,
                "timestamp": "2021-12-14T22:49:45+00:00"
            },
            "accounts": [
                {
                    "id": "304XPWAKYK",
                    "foundation": "3X82D3H7DT",
                    "currency": "USD".
                    "payment_type": "EFT",
                    "active": true
                },
                {
                    "id": "BX87AKPXHZ",
                    "foundation": "8DUNG7YM9D",
                    "currency": "USD".
                    "payment_type": "EFT",
                    "active": true
                }
            ],
            "logos": [
                {
                    "size": "400x400",
                    "url": "https://logos.benevity.org/400x400/public/clogos/840-300108263.png"
                },
                {
                    "size": "50x50",
                    "url": "https://logos.benevity.org/50x50/public/clogos/840-300108263.png"
                },
                {
                    "size": "300x300",
                    "url": "https://logos.benevity.org/300x300/public/clogos/840-300108263.png"
                },
                {
                    "size": "150x150",
                    "url": "https://logos.benevity.org/150x150/public/clogos/840-300108263.png"
                }
            ]
        }
    }
}

# Response Details:

Many of the response attributes are self-descriptive, but some of them may require a bit more clarity:

  • caption - a shorter description of the cause, better suited for embedding when length or space may be a concern
  • description - the full description of the cause
    • both caption and description escape any special characters such as newlines, indentations, or quotations
  • active - whether or not the cause is active in the Benevity ecosystem
  • disbursable - whether or not funds can be disbursed to the cause
    • the cause may be active, but not be disbursable, like in the case that they are based outside of North America without EFT setup
  • twitter - the twitter username of the cause
  • categories - causes are classified using the NTEE IRS specification. (opens new window)
  • certification - whether or not the cause owner has completed the Self-Certification Declaration. (opens new window) and related timestamps
  • claimed - timestamp of when a cause owner claimed responsibility for the cause's profile and activities
  • owner_verified - whether or not the cause owner has been verified by the Benevity Vetting team
  • accounts - The type of accounts as an array, based on certain foundations (AOGF, UKOGF, COGF) in which the cause will receive the funds as EFT, CHEQUE, PAYPAL.
    • NOTE: If the cause has not received any donation, there will be no account listed. This means we are unable to accurately determine how the funds will be disbursed until the donation is completed.

# 🚀 ☀️ ⭐️ Congratulations! ⭐️ ☀️ 🚀

You have now obtained all of the information necessary to build a richer cause integration, to help your users drive further goodness in the world!