Get a record
GET/records/:collection/:id
Needs the Records add-on and the records:read scope.
Request
Responses
- 200
- default
The record.
Response Headers
X-Request-Id
The id of this request. Quote it when you contact support.
Hometown-Version
The API version that answered: the one the request named, or the version the account is pinned to.
RateLimit-Policy
The per-minute limit of the account, as limit;w=60.
RateLimit
Requests left in the current minute: limit, remaining and reset in seconds.
Every error is a problem details body; code says which.
| HTTP | Code | When |
|---|---|---|
| 400 | invalid_request | The request is malformed. |
| 401 | api_key_missing | The request has no API key. |
| 401 | api_key_invalid | The key does not match any Hometown key. |
| 401 | api_key_revoked | The key was revoked and no longer works. |
| 401 | api_key_expired | The key was rotated and its 7-day overlap period ended. |
| 403 | scope_missing | The key lacks the scope this operation requires, or the operation belongs to the Records add-on, which the account does not have. |
| 403 | tenant_suspended | The account is pending activation or suspended, and every key of the account is refused. |
| 403 | terms_not_accepted | The account has not accepted the current API Terms and Data Processing Agreement, and the 30 days after they took effect are over. |
| 403 | ip_not_allowed | The request came from an IP address outside the allowlist of the key. |
| 403 | api_key_paused | The key is paused because its activity looked unlike its usual traffic. |
| 403 | test_key_on_live_route | This operation accepts only a live key. |
| 404 | not_found | No resource with this id exists in this account and environment, or the path is not part of the API. |
| 429 | rate_limited | The key exceeded the per-minute limit of the account. |
| 429 | daily_quota_reached | The account reached its daily request limit. |
| 429 | sandbox_daily_cap_reached | The test keys of an account make up to 200 estimates a day together, sandbox inputs included. |
| 500 | internal_error | The request failed inside Hometown. |
Response Headers
X-Request-Id
The id of this request. Quote it when you contact support.
Hometown-Version
The API version that answered: the one the request named, or the version the account is pinned to.