Error

The failure envelope. Every failure, without exception.

Returned byevery endpoint

Fields #

FieldTypeNotes
error.typestringThe machine-readable reason. Switch on this, never on the message.
error.messagestringFor a human. Wording can change; the type cannot.
error.fieldstringWhich request field was at fault, where one was.
error.requestIdstringQuote it in a support conversation and we can find the request.

Absent is not null: a field we did not get is omitted rather than sent as an empty string, so you can tell "LinkedIn does not have this" from "this person left it blank".

Sample #

JSON
{
  "error": {
    "type": "invalid_request",
    "message": "max_results may not exceed 2500 for /v1/sales/search/people - that is LinkedIn's own ceiling",
    "field": "max_results",
    "requestId": "req_8f2ka91x"
  }
}