Organizations

Screen up to 100 organizations in one call

The bulk form of /screening/{ein}, running byte-identical logic per EIN — a bulk screen that disagreed with the single-EIN screen would be worse than none. Candid's bulk Charity Check takes 25 organizations; this takes 100. Costs ONE call from your monthly allowance, not one per EIN. report_date and sources are returned once for the batch, since every row is screened against the same reference files.

post/api/v1/screening/bulk

Request

Base URL: https://data.useplinth.com
URL: https://data.useplinth.com/api/v1/screening/bulk
Auth: API key in header X-API-Key

Query parameters

compatstring nullable

Set to candid to render this record the way Candid's documentation describes it — notably booleans as the strings "True"/"False". A RENDERING flag only: it never changes which records match, or what they say.

Request body

einsstring[] required

Up to 100 EINs. Any format — normalized per EIN.

Example request

{
  "eins": [
    "043407816",
    "13-1837418"
  ]
}

Response

Screens for every valid EIN in the request.

codeinteger

messagestring required

results_countinteger required

resultsobject[] required

invalid_einsstring[] required

Inputs that were not usable EINs, echoed back rather than dropped.

report_datestring nullable

sourcesobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.