API Reference
The API is a JSON REST API served under /api/v1 (/api/v2/<path> is an alias of the same routes). Its OpenAPI schema is generated from the code, not hand-written here, so it matches what the API accepts and returns.
What is not published
Section titled “What is not published”The interactive Swagger page and the schema file are switched off on the production service. If you are building an integration and need the schema for the routes you use, ask support from inside the application.
Where to start
Section titled “Where to start”- Authentication: bearer tokens for the signed-in API, and API keys for the public API.
- Errors: the status codes and the shapes of error bodies.
- Rate Limits: the limits and the
Retry-Afterheader.
Public API
Section titled “Public API”An API key created in the application gives read access to the public API: contract search (GET /api/v1/public/v1/contracts/search, with q, naics, agency and limit), contract detail, and webhook registration. It returns the contract data the platform holds. See Data Sources for what that is.
Notifications
Section titled “Notifications”Two routes back the notification settings in the app:
GET /api/v1/notificationslists a person’s notifications. Passgroup=searchto fold saved-search matches into one group per search.GETandPUT /api/v1/notifications/preferencesread and save a person’s notification preferences. The save replaces the whole body. An unknown kind or an out-of-range value answers422and changes nothing.
Related
Section titled “Related”Try this in the platform