Providers

List providers

GET/api/v1/providers

The providers of the key's organization in the key's mode (test or live), by last name, one page at a time. Filter by status, or search by the words of a name or the digits of an NPI.

Needs a key with read permission.

Request

Query parameters

Query parameters
Name	Type	Required	Description
limit	integer	optional	How many items to return, from 1 to 100. Default 25.At least 1.At most 100.
cursor	string	optional	The next_cursor of the previous page, to get the page after it. Opaque: pass it back unchanged.
status	string	optional	Only providers with this status.One of: `active`, `inactive`.
q	string	optional	Words of a name or digits of an NPI, in any case: every word must be found. Use up to 100 characters, with no control characters.At most 100 characters.

Response

A page of providers. Status 200.

Response fields
Name	Type	Description
data	array of object
data[].id	string	An ID that starts with prv_.
data[].object	string	Always `provider`.
data[].first_name	string	At most 35 characters.
data[].last_name	string	At most 60 characters.
data[].credential	string	The credential after the name, such as DDS. Empty when there is none.At most 10 characters.
data[].npi	string	The provider's individual NPI.
data[].license	object or null	The state license sent on claims, or null when none is on file.
data[].license.number	string
data[].license.state	string	The two-letter code of the state that issued the license.
data[].taxonomy_code	string	The NUCC taxonomy code sent on claims.
data[].specialty	string	The specialty the taxonomy code stands for (General dentistry, Orthodontics...), or the code itself when it is not one of the dental codes.
data[].status	string	One of: `active`, `inactive`.
data[].mode	string	One of: `test`, `live`.
data[].created_at	string (date-time)
data[].updated_at	string (date-time)
next_cursor	value	Pass as cursor to get the next page; null when there is no next page.

Errors

Errors
HTTP status	Code	What it means
401	UNAUTHORIZED	A valid API key is required. Send it as "Authorization: Bearer <key>".
403	PERMISSION_DENIED	This API key is not allowed to do that.
422	INVALID_REQUEST	The request is not valid.
504	TIMEOUT	The request took too long to finish. It may still have taken effect: look it up before sending it again with a new Idempotency-Key. What it made is found with GET /api/v1/eligibility?request_id=<this request_id>, and the same filter on /api/v1/claims and /api/v1/attachments (a key with read permission).
500	INTERNAL	Something went wrong on our side. Quote the request ID if you contact us.

Example

Example request

Shell

curl "https://sandbox.myclaimhouse.com/api/v1/providers?status=active&limit=25" \
  -H "Authorization: Bearer $CLAIMHOUSE_KEY"

Example response: 200

JSON

{
  "data": [
    {
      "id": "prv_01JM000000E008000000000005",
      "object": "provider",
      "first_name": "Riley",
      "last_name": "Example",
      "credential": "DDS",
      "npi": "1999990017",
      "license": {
        "number": "GA-000000",
        "state": "GA"
      },
      "taxonomy_code": "1223G0001X",
      "specialty": "General dentistry",
      "status": "active",
      "mode": "test",
      "created_at": "2026-01-15T14:00:00+00:00",
      "updated_at": "2026-01-15T14:00:00+00:00"
    }
  ],
  "next_cursor": null
}