GovDash
Menu

Companies

List companies

Returns the companies in the authenticated team's Data Library, ordered by name by default. Sub-teams' companies are not included. Companies above the token's classification ceiling are left out. For example, GET /v1/companies?limit=5 returns the first five companies.

gethttps://api.govdash.us/v1/companies

Authorization

Authorizationstringheaderrequired

Your API key as a bearer token, for example Bearer gd_live_....

See Authentication for how to create a key.

Query parameters

cursorstringquery

Return the objects after this cursor: the previous page's pageInfo.endCursor, or any edge's cursor. Omit it to start at the first page.

limitintegerquerydefault: 20

Number of objects to return, from 1 to 100. Defaults to 20.

sort_byenumquery

Sort field. Defaults to name.

One of:created_atupdated_atname

sort_directionenumquery

Sort direction. Keep the same sort and filters when following a cursor.

One of:ascdesc

updated_sincestring (date-time)query

Only records updated at or after this time.

namestringquery

Only companies whose legal name contains this text, ignoring case.

Headers

govdash-versionenumheaderrequired

The dated API version this request is written against. Responses keep that version's shape after newer versions ship.

One of:2026-11-17

Response

200 · application/json

One page of a list.

edgesobject[]

The objects on this page, in list order.

Show child attributes
nodeobject
Show child attributes
idstring

Company identifier.

objectstring

Object type, always company.

classificationenum

Data classification of the company.

One of:UNCLASSIFIEDCUI

namestring

Legal name, unique within the team.

dba_namestring | null

Doing-business-as or trade name.

relationship_typeenum

How the company relates to the team.

One of:PRIME_CONTRACTORSUB_CONTRACTORTEAM_ARRANGEMENT_MEMBERJOINT_VENTURE_MEMBERSUBSIDIARYPARENT_COMPANYUNKNOWNSUPPLIERCUSTOMERCOMPETITORVENDORINCUMBENTOUR_TEAM

relationship_notesstring | null

Free-text notes on the relationship with the team.

website_urlstring | null

Website URL.

ueistring | null

SAM Unique Entity Identifier.

cage_codestring | null

CAGE code.

duns_numberstring | null

DUNS number.

updated_atstring (date-time)

When the company was last updated.

locationobject | null

Primary address. null when none is recorded.

Show child attributes
address_line_1string | null

First line of the street address.

address_line_2string | null

Second line of the street address.

citystring | null

City.

statestring | null

State or region name.

state_codestring | null

State or region code, such as VA.

postal_codestring | null

Postal or ZIP code.

countrystring | null

Country name.

country_codestring | null

Country code, such as US.

cursorstring

Pass as cursor to fetch the objects after this one.

pageInfoobject

Where this page sits in the list.

Show child attributes
hasNextPageboolean

Whether more objects follow this page. Pass endCursor as cursor to fetch them.

hasPreviousPageboolean

Whether this page was fetched after a cursor.

startCursorstring | null

The first edge's cursor. null when the page is empty.

endCursorstring | null

The last edge's cursor. null when the page is empty.

Errors

Every error returns a stable error.code to branch on and an error.message that says what went wrong, like the examples below. See Errors for how to handle each one.

400bad_request

A query parameter is malformed, such as a changed or reused cursor.

The cursor is invalid. Pass an `endCursor` or edge `cursor` unchanged.

401unauthorized

The API key is missing, mistyped, revoked, or expired.

The bearer token is missing or invalid.

403forbiddenclassification_out_of_scope

The key's service account doesn't have the permission this needs, or your team's access has ended.

You do not have permission to perform this action.

413payload_too_large

The request body is over 1 MB.

The request body must not exceed 1 MB.

422validation_failed

The request is well formed, but GovDash won't make this change. The message says why, when it can.

The request failed validation.

429rate_limited

You sent too many requests. Wait the seconds in the retry-after header, then retry.

This access token exceeded its read rate limit.

500internal_error

Something went wrong on GovDash's side, usually a bug. Retry with backoff, and check before retrying a create.

An unexpected error occurred.

503service_unavailable

GovDash is briefly unavailable and didn't run the request. Retry after retry-after.

The service is temporarily unavailable. Try again later.

get/v1/companies

List companies

Sends a real request to GovDash with the key you enter.

Query parameters
string

Return the objects after this cursor: the previous page's pageInfo.endCursor, or any edge's cursor. Omit it to start at the first page.

integer

Number of objects to return, from 1 to 100. Defaults to 20.

enum

Sort field. Defaults to name.

enum

Sort direction. Keep the same sort and filters when following a cursor.

string (date-time)

Only records updated at or after this time.

string

Only companies whose legal name contains this text, ignoring case.

Bearer

Kept in this tab only. Use a key you can revoke.

Request
Response
Send the request to see the response.