Create a verification request

curl -X POST https://api.givechariot.com/v1/verification_requests \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "ein": "123456789",
  "organization_name": "Local Community Foundation",
  "recommended_mailing_address": {
    "line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94105"
  }
}'

{
  "id": "vr_01jpjen1s23s29kkmnjsb6fzga",
  "ein": "123456789",
  "organization_name": "Local Community Foundation",
  "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct",
  "status": "needs_review",
  "website": "https://localfoundation.org",
  "recommended_mailing_address": {
    "line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94105",
    "line2": "Suite 100"
  },
  "verified_at": "2024-01-15T09:30:00Z",
  "failed_at": "2024-01-15T09:30:00Z",
  "created_at": "2020-01-31T23:00:00Z",
  "updated_at": "2020-01-31T23:00:00Z"
}

Request verification of an unlisted organization. If the organization cannot be found through Chariot's search, you can submit a verification request so that Chariot's compliance team can review and verify the organization.

Authentication

AuthorizationBearer

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

Request

The request to create a verification request for an unlisted organization.

einstringRequired

The EIN of the organization to verify

organization_namestringRequired

The name of the organization as known to the grantmaker

recommended_mailing_addressobjectRequired

A mailing address for the organization being verified.

websitestringOptional

The organization's website URL

contact_emailstringOptional

Contact email for the nonprofit organization.

Response headers

Locationstring

The URI of the created object

Response

The verification request was created

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

websitestring

The organization's website URL

recommended_mailing_addressobject

A mailing address for the organization being verified.

verified_atdatetimeRead-only

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

failed_atdatetimeRead-only

When the verification request was rejected

created_atdatetimeRead-only

When the verification request was created

updated_atdatetimeRead-only

When the verification request was last updated

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

412

Precondition Failed Error