Bellwork
Operators

Search operators

Search operators: whoever runs childcare centers or Head Start programs and is not a school district. A merged operator is never listed. `state` is where one runs active centers or Head Start programs, not only where its office is, and it scopes center_count, center_seats, head_start_count and head_start_slots to those states. The 990 filters read its returns that count: for each tax period, the current return, once read.

GET
/operators

Search operators: whoever runs childcare centers or Head Start programs and is not a school district. A merged operator is never listed. state is where one runs active centers or Head Start programs, not only where its office is, and it scopes center_count, center_seats, head_start_count and head_start_slots to those states. The 990 filters read its returns that count: for each tax period, the current return, once read.

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Query Parameters

state?string

State abbreviation, or a comma-separated list: where it runs centers or programs

kind?string

Comma-separated, in any case: nonprofit, company, government, tribe, church, other

min_centers?integer

Active childcare centers it runs, at least this

Range0 <= value <= 2147483647
max_centers?integer

Active childcare centers it runs, at most this

Range0 <= value <= 2147483647
min_seats?integer

Licensed capacity of those centers, summed, at least this

Range0 <= value <= 2147483647
max_seats?integer

Licensed capacity of those centers, summed, at most this

Range0 <= value <= 2147483647
runs_head_start?string

true or false: runs a Head Start program with an open site

min_revenue?number

Total revenue on its latest 990, at least this

max_revenue?number

Total revenue on its latest 990, at most this

min_government_grants?number

Government grants on its latest 990, at least this

max_government_grants?number

Government grants on its latest 990, at most this

paid_contractor?string

Paid a contractor over $100,000 whose name contains this, case, spaces and punctuation aside; several names joined with |, at most 20 names, each at most 200 characters. A 990-EZ's contractors are not read yet, so a 990-EZ filer never matches.

paid_contractor_in?string

any or latest: which of its 990s the contractor filter reads

Default"any"
search?string

Operator name contains this, or its tax ID is exactly this; at most 200 characters

Lengthlength <= 200
ids?string

Comma-separated operator UUIDs. An ID merged into another operator reads as the operator it became.

order_by?string

name, state, kind, center_count, center_seats, head_start_count, head_start_slots, total_revenue, government_grants, created_at, updated_at

Default"name"
order_ascending?string

Sort direction

Default"true"
limit?integer

Results per page, at most 10,000

Default50
Range1 <= value <= 10000
offset?integer

Pagination offset

Default0

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/operators"
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "slug": "string",
      "name": "string",
      "kind": "nonprofit",
      "ein": "string",
      "uei": "string",
      "chain_key": "string",
      "ntee_code": "string",
      "physical_address": "string",
      "physical_city": "string",
      "state": "string",
      "physical_zip": "string",
      "website_url": "string",
      "website_domain": "string",
      "brand_favicon_url": "string",
      "brand_hero_url": "string",
      "brand_color": "string",
      "created_at": "string",
      "updated_at": "string",
      "center_count": -9007199254740991,
      "center_seats": -9007199254740991,
      "head_start_count": -9007199254740991,
      "head_start_slots": -9007199254740991,
      "program_states": [
        "string"
      ],
      "total_revenue": 0,
      "government_grants": 0,
      "fiscal_year_end": "string",
      "latest_990_form": "990",
      "latest_990_object_id": "string",
      "contractor_matches": [
        {
          "name": "string",
          "amount": 0,
          "services": "string",
          "line_key": "string",
          "fiscal_year_end": "string"
        }
      ],
      "contractor_paid": "string"
    }
  ],
  "pagination": {
    "total": -9007199254740991,
    "limit": -9007199254740991,
    "offset": -9007199254740991,
    "has_more": true
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
Empty
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}