Errors

The following is a list of common errors you may encounter when interacting with our API:

400 Bad Request

Encountered when making a request that is passing invalid value types or is in the wrong format. Multiple validation errors will listed in the errors array:

1
{
2
  "errors": [
3
    {
4
      "field": "payer.name",
5
      "message": "Expected name to be of type string, but received number"
6
    },
7
    {
8
      "field": "filingYear",
9
      "message": "Expected filingYear to be of type number, but received string"
10
    }
11
  ]
12
}

401 Unauthorized

Typically encountered when making a request with invalid credentials.

1
{
2
  "message": "Unauthorized"
3
}

404 Not Found

Typically encountered when trying to fetch a record that has not been created or you don’t have access to.

1
{
2
  "message": "Not Found"
3
}

409 Conflict

Encountered when trying to create a record with a foreignId that already exists.

1
{
2
  "message": "Conflict"
3
}

500 Internal Server Error

Typically encountered when something unexpected went wrong. We automatically generate high-priority tickets for these types of errors and address them ASAP.

1
{
2
  "message": "Internal Server Error"
3
}