GovDash
Menu

People

Retrieve a person

Returns one person owned by the authenticated team. People on other teams or sub-teams, or above the token's classification ceiling, are reported as not found.

gethttps://api.govdash.us/v1/people/{id}

Authorization

Authorizationstringheaderrequired

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

See Authentication for how to create a key.

Path parameters

idstringpathrequired

Person identifier.

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

A person in the team's Data Library.

idstring

Person identifier.

objectstring

Object type, always person.

classificationenum

Data classification of the person.

One of:UNCLASSIFIEDCUI

namestring

Full display name, combined from the name parts.

titlestring | null

Name prefix, title, or rank such as Dr., CPL, or Gen.

first_namestring | null

First (given) name.

middle_namestring | null

Middle name.

last_namestring | null

Last (family) name.

suffixstring | null

Name suffix such as Jr., Sr., or III.

emailstring | null

Email address.

phonestring | null

Phone number.

linkedin_urlstring | null

LinkedIn profile URL.

updated_atstring (date-time)

When the person was last updated.

employmentsobject[]

Companies and agencies the person works for. Employers the token cannot read are left out.

Show child attributes
company_idstring | null

Identifier of the employing company.

agency_idstring | null

Identifier of the employing agency.

is_primaryboolean

Whether this is the person's primary employment.

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 path or query parameter is malformed.

Invalid request path parameters: Expected a non-empty string

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.

404not_found

The record doesn't exist, belongs to another team, or is above the key's classification.

The requested resource was not found.

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/people/{id}

Retrieve a person

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

Path parameters
string, required

Person identifier.

Bearer

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

Request
Response
Send the request to see the response.