---
updatedAt: 2026-09-30T19:05:11.000Z
agentTools:
  projectIndex: https://developer.candid.org/llms.txt
---

# /charitycheck/v1

Check whether charitable organizations may or may not operate in California with Attorney General Registry and Franchise Tax Board data.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "CharityCheck",
    "version": "1.0",
    "description": "Validate nonprofit status and eligibility of a single organization with a 100% IRS compliant charity check. Ensure charities are compliant within key databases including IRS Publication 78, IRS Business Master File, Internal Revenue Bulletin, Automatic Revocation of Exemption, and OFAC Specially Designated National list. Gather additional details to support decision making like organization type, deductibility limitations, religious organization status, revocations, and more. Download a date and timestamped charity check PDF document to archive for due diligence via the included Charity Check PDF API. "
  },
  "servers": [
    {
      "url": "https://api.candid.org/charitycheck"
    },
    {
      "url": "https://apidata.guidestar.org/charitycheck"
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKeyHeader": {
        "type": "apiKey",
        "name": "Subscription-Key",
        "in": "header"
      },
      "apiKeyQuery": {
        "type": "apiKey",
        "name": "Subscription-Key",
        "in": "query"
      }
    },
    "schemas": {
      "BadRequest": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP response status code.",
            "example": 400
          },
          "message": {
            "type": "string",
            "description": "Diagnostic message for response status",
            "example": "The request cannot be fulfilled due to bad syntax."
          }
        }
      },
      "Unauthorized": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP response status code.",
            "example": 401
          },
          "message": {
            "type": "string",
            "description": "Diagnostic message for response status",
            "example": "Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API."
          }
        }
      },
      "Forbidden": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP response status code.",
            "example": 403
          },
          "message": {
            "type": "string",
            "description": "Diagnostic message for response status",
            "example": "Forbidden, we found insufficient permissions to grant access to the resources. Please check the detailed message of the response."
          }
        }
      },
      "NotFound": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP response status code.",
            "example": 404
          },
          "message": {
            "type": "string",
            "description": "Diagnostic message for response status",
            "example": "Request was processed successfully but we could not find the resource ein"
          }
        }
      },
      "NotAcceptable": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP response status code.",
            "example": 406
          },
          "message": {
            "type": "string",
            "description": "Diagnostic message for response status",
            "example": "The requested resource is capable of generating only content not acceptable according to the Accept headers sent in the request."
          }
        }
      },
      "TooManyRequests": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP response status code.",
            "example": 429
          },
          "message": {
            "type": "string",
            "description": "Diagnostic message for response status",
            "example": "Rate limit is exceeded. Try again later."
          }
        }
      },
      "InternalServerError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP response status code.",
            "example": 500
          },
          "message": {
            "type": "string",
            "description": "Diagnostic message for response status",
            "example": "Oh no!, this is bad, something went wrong... please contact API support!"
          }
        }
      }
    }
  },
  "security": [
    {
      "apiKeyHeader": []
    },
    {
      "apiKeyQuery": []
    }
  ],
  "paths": {
    "/v1/{state}/{ein}": {
      "get": {
        "summary": "/charitycheck/v1",
        "description": "Check whether charitable organizations may or may not operate in California with Attorney General Registry and Franchise Tax Board data.",
        "operationId": "charitycheck_v1_state",
        "parameters": [
          {
            "name": "state",
            "x-global": true,
            "in": "path",
            "description": "State Name Abbreviation",
            "example": "ca",
            "required": true,
            "schema": {
              "type": "string",
              "default": "ca"
            }
          },
          {
            "name": "ein",
            "x-global": true,
            "in": "path",
            "description": "Employer Identification Number.",
            "example": "13-1837418",
            "required": true,
            "schema": {
              "type": "string",
              "default": "13-1837418"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "description": "HTTP response status code.",
                      "example": 200
                    },
                    "message": {
                      "type": "string",
                      "description": "Diagnostic message for response status",
                      "example": "OK"
                    },
                    "took": {
                      "type": "integer",
                      "description": "Time taken for request to process",
                      "example": 10
                    },
                    "errors": {
                      "type": "array",
                      "description": "List of errors encountered",
                      "items": {
                        "type": "object",
                        "properties": {
                          "resource": {
                            "type": "string",
                            "example": ""
                          },
                          "reason": {
                            "type": "string",
                            "example": ""
                          }
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "ein": {
                          "type": "string",
                          "description": "Nine digit Federal Employer ID Number (Tax ID) assigned by the IRS if known by the Registry of Charitable Trusts. The dash (-) that separates the second and third digits is not contained in the data kept by the Registry of Charitable Trusts.",
                          "example": "47-3438111"
                        },
                        "california_entity_id": {
                          "type": "string",
                          "description": "Secretary of state, FTB number, or organization unique identifier in California.",
                          "example": "1326"
                        },
                        "organization_name": {
                          "type": "string",
                          "description": "Name of organization as registered with the Registry of Charitable Trusts and/or as recorded with the Secretary of State.",
                          "example": "1610 FOUNDATION INC."
                        },
                        "city": {
                          "type": "string",
                          "description": "The city listed by the organization on registration and renewal documentation. For organizations that are not  registered, this may be the city as reported by the Secretary of State or other sources.",
                          "example": "BUENA PARK"
                        },
                        "state": {
                          "type": "string",
                          "description": "The state listed by the organization on registration and renewal documents. For organizations that are not registered, this may be the state as reported by the Secretary of State or other sources.",
                          "example": "CA"
                        },
                        "attorney_general": {
                          "type": "object",
                          "properties": {
                            "ag_may_operate_or_solicit_in_ca": {
                              "type": "string",
                              "description": "Whether the organization may operate or solicit donations in California. One of \"Yes\", \"No\", \"Not Operating/Dissolved\" or \"Undetermined\"; only \"Yes\" means the organization may operate. The value is derived from the organization's entity status and charitable registration status in the CA Attorney General's Registry of Charities. \"Undetermined\" means no determination could be made, for example because the organization holds no charitable registration; it does not indicate the organization may operate. Use this field rather than ag_registry_status to determine good standing.",
                              "example": "Yes"
                            },
                            "ag_registry_status": {
                              "type": "string",
                              "nullable": true,
                              "description": "Status of the organization's charitable registration with the CA Attorney General's Registry of Charities. One of \"Registered\", \"Registered - Exempt\", \"Delinquent\", \"Suspended\", \"Revoked\", \"Pending Renewal\", \"Not Registered\" or \"Merged Out\". Null when the organization holds no charitable registration. Use ag_may_operate_or_solicit_in_ca to determine good standing.",
                              "example": "Registered"
                            },
                            "ag_state_charity_reg_num": {
                              "type": "string",
                              "nullable": true,
                              "description": "The organization's charitable registration number with the CA Attorney General's Registry of Charities. Older numbers are six digits, many with leading zeros. Those issued since 2007 begin with 'CT' followed by seven numbers. Null when the organization holds no charitable registration.",
                              "example": "CT0257773"
                            },
                            "ag_issue_date": {
                              "type": "string",
                              "description": "The date on which the organization was approved for registration by the Registry of Charitable Trusts.",
                              "example": "2018-05-15"
                            },
                            "ag_last_renewal_date": {
                              "type": "string",
                              "nullable": true,
                              "deprecated": true,
                              "description": "Deprecated. The CA Attorney General no longer publishes this date, so it is always null.",
                              "example": null
                            },
                            "ag_status_set_date": {
                              "type": "string",
                              "nullable": true,
                              "deprecated": true,
                              "description": "Deprecated. The CA Attorney General no longer publishes this date, so it is always null.",
                              "example": null
                            },
                            "ag_as_of_date": {
                              "type": "string",
                              "description": "The date of the Registry of Charities snapshot the data was taken from. The same date applies to every organization in the snapshot; it does not indicate when this organization's record last changed.",
                              "example": "2026-08-25"
                            },
                            "ag_source_data_conflict": {
                              "type": "boolean",
                              "description": "Organization provided information to Candid that this is not a delinquent organization. Typically this scenario happens between data loads. Will be reset after each data load.",
                              "example": true
                            },
                            "ag_source_data_conflict_date": {
                              "type": "string",
                              "description": "Date when organization provided information to Candid that this is not a delinquent organization. Typically this scenario happens between data loads. Will be reset when FTB removes the revocation.",
                              "example": "2023-05-18"
                            },
                            "most_recent_ag": {
                              "type": "string",
                              "description": "Date of most recent AG list available.",
                              "example": "2023-04-19"
                            }
                          }
                        },
                        "franchise_tax_board": {
                          "type": "object",
                          "properties": {
                            "ftb_revocation_status": {
                              "type": "boolean",
                              "description": "If this organization is on the Franchise Tax Board list.",
                              "example": true
                            },
                            "ftb_revocation_status_date": {
                              "type": "string",
                              "description": "Date Franchise Tax Board revoked tax-exempt status.",
                              "example": "2017-03-28"
                            },
                            "most_recent_ftb": {
                              "type": "string",
                              "description": "Date of most recent Franchise Tax Board list available.",
                              "example": "2023-04-19"
                            },
                            "ftb_source_data_conflict": {
                              "type": "boolean",
                              "description": "\tOrganization provided information to Candid that this is\n  not a revoked organization. Typically this scenario happens\n  between data loads. Will be reset after each data load.",
                              "example": true
                            },
                            "ftb_source_data_conflict_date": {
                              "type": "string",
                              "description": "Date when organization provided information to Candid that this is not a revoked organization. Typically this scenario happens between data loads. Will be reset when Franchise Tax Board removes the revocation.",
                              "example": "2023-05-17"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BadRequest"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/BadRequest"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Unauthorized"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/Unauthorized"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Forbidden"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/Forbidden"
                }
              }
            }
          },
          "404": {
            "description": "No Results Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotFound"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotFound"
                }
              }
            }
          },
          "406": {
            "description": "Not Acceptable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotAcceptable"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotAcceptable"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TooManyRequests"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TooManyRequests"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InternalServerError"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/InternalServerError"
                }
              }
            }
          }
        }
      }
    }
  }
}
```