Contracts
Retrieve a contract
Returns one contract owned by the authenticated team. Contracts on other teams or sub-teams, or above the token's classification ceiling, are reported as not found.
gethttps://api.govdash.us/v1/contracts/{id}
Authorization
Your API key as a bearer token, for example Bearer gd_live_....
See Authentication for how to create a key.
Path parameters
Contract identifier.
Query parameters
Related objects to include: past_performance.writeups. Repeat the parameter or separate keys with commas.
Headers
The dated API version this request is written against. Responses keep that version's shape after newer versions ship.
One of:
Response
200 · application/jsonA contract award the team tracks. Amounts are null when the token's user cannot read sensitive contract details.
Contract identifier.
Object type, always contract.
Team that owns the contract.
When the contract was last updated.
Contract title.
Canonical contract identifier, derived from the contract, task order and subcontract numbers the contract has.
Processing status of the contract.
One of:
Data classification of the contract.
One of:
Identifier of the awarding agency.
Identifier of the funding agency.
Identifier of the company that holds the contract.
Start of the period of performance.
End of the currently exercised period of performance.
End of the full period of performance, including all options.
Primary past performance, included in detail and write responses. Null when none is recorded. Use expand[]=past_performance.writeups on retrieval for write-up summaries.
Show child attributesHide child attributes
Show child attributesHide child attributes
When the write-up was last updated.
Base award amount in US dollars.
Amount obligated by the agency in US dollars.
Current contract value in US dollars: the base and all exercised options.
Ceiling contract value in US dollars: the value including all options.
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.
A path or query parameter is malformed, such as an expand[] value this endpoint doesn't support.
Invalid request query parameters: unknown expand key "owner". Allowed keys: past_performance.
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.
The record doesn't exist, belongs to another team, or is above the key's classification.
The requested resource was not found.
The request is well formed, but GovDash won't make this change. The message says why, when it can.
The request failed validation.
You sent too many requests. Wait the seconds in the retry-after header, then retry.
This access token exceeded its read rate limit.
Something went wrong on GovDash's side, usually a bug. Retry with backoff, and check before retrying a create.
An unexpected error occurred.
GovDash is briefly unavailable and didn't run the request. Retry after retry-after.
The service is temporarily unavailable. Try again later.