For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact usLogin
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • Introduction
    • Overview
    • Authentication
    • Errors
    • Software Development Kits
    • Webhooks and Events
    • Sandbox Simulations
  • Core Resources
  • DAFpay
  • Disbursements
      • GETList verification requests
      • POSTCreate a verification request
      • GETGet a verification request
  • Gift Processing
LogoLogo
Contact usLogin
DisbursementsVerification Requests

Get a verification request

GET
/v1/verification_requests/:id
GET
/v1/verification_requests/:id
$curl https://api.givechariot.com/v1/verification_requests/id \
>     -H "Authorization: Bearer <token>"
1{
2  "id": "vr_01jpjen1s23s29kkmnjsb6fzga",
3  "ein": "123456789",
4  "organization_name": "Local Community Foundation",
5  "organization_id": "org_01j8rs605a4gctmbm58d87mvsj",
6  "status": "needs_review",
7  "website": "https://localfoundation.org",
8  "recommended_mailing_address": {
9    "line1": "123 Main St",
10    "city": "San Francisco",
11    "state": "CA",
12    "zip_code": "94105",
13    "line2": "Suite 100"
14  },
15  "verified_at": "2024-01-15T09:30:00Z",
16  "failed_at": "2024-01-15T09:30:00Z",
17  "created_at": "2020-01-31T23:00:00Z",
18  "updated_at": "2020-01-31T23:00:00Z"
19}
Get a specific verification request by its unique identifier.
Was this page helpful?
Previous

Create Nonprofit Addresses

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired
The unique identifier of the verification request

Response

The verification request
idstringRead-only
Unique identifier for the verification request
einstring
The EIN of the organization being verified
organization_namestring
The name of the organization as provided by the grantmaker
organization_idstring
The ID of the Organization record for the nonprofit being verified.
statusenum

The status of the verification request. Possible values include:

  • needs_review: The request has been submitted and is awaiting review by Chariot’s compliance team
  • verified: The organization has been verified as tax-exempt and eligible for disbursements
  • failed: Chariot’s compliance team determined the organization is not eligible
Allowed values:
websitestring
The organization's website URL
recommended_mailing_addressobject
A mailing address for the organization being verified.
verified_atstringRead-onlyformat: "date-time"

When the organization was verified as tax-exempt and eligible for disbursements

failed_atstringRead-onlyformat: "date-time"
When the verification request was rejected
created_atstringRead-onlyformat: "date-time"
When the verification request was created
updated_atstringRead-onlyformat: "date-time"
When the verification request was last updated

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error