Error responses are largely based on standard HTTP error types, however, some errors may be more specific to Funding Circle's API strucutre. Responses for errors will include the following information and in the event of multiple errors a generic message will used with more specific information inside the main message.

The errors below are grouped by Error Number.

400 Errors

Invalid UUID

{
  "message": "ID is invalid",
  "error_details": [
    {
      "attribute": "id",
      "code": "invalid",
      "message": "is invalid"
    }
  ],
  "_links": { },
  "_embedded": { }
}

Invalid Parameters

{
  "message": "Invalid param(s): asdf terms[]",
  "error_details": [ ],
  "_links": { },
  "_embedded": { }
}

401 Errors

No Token Provided

{
  "message": "Not authenticated"
}

Login Failed

{
  "message": "Invalid username\/password"
}

403 Errors

Listing has already been purchased

{
  "errors": [
    {
      "message": "Listing is not live"
    }
  ]
}

Listing is not live yet

{
  "errors": [
    {
      "message": "Listing is not live"
    }
  ]
}

There is not enough money available in your cash balance

{
  "errors": [
    {
      "message": "You do not have enough money to complete this order"
    }
  ]
}

404 Errors

Listing not found

{
  "errors": [
    {
      "message": "404 - LE error: Holding does not exist, or is not owned by the investor"
    }
  ]
}

429 Error

Too many requests per second. Currently we allow for 40 requests per second. Please reduce the speed at which you are making calls to our API.

500

Unexpected Character

JSON error (unexpected character): ȝ
  • Application has an exception

Listing not found

{
  "message": "Listing not found",
  "error_details": [ ],
  "_links": { },
  "_embedded": { }
}

503 Errors

Server is down