Errors
Errors return the appropriate status with a JSON body containing an error
string.
| Status | Cause |
|---|---|
400 | A domain we do not track, a malformed date, or a parameter out of range. |
401 | Missing or invalid token. |
403 | A company outside your token's scope. |
404 | No such route. |
405 | Only GET is supported. |
An unknown domain names the nearest match rather than returning an empty result,
because an empty 200 for a typo reads as "nothing shipped":
{
"error": "unknown domain 'nope.com' — did you mean 'notion.com'?"
}
A company outside your token's scope is refused rather than dropped from the result, for the same reason:
{
"error": "this token does not include openai.com"
}