API Reference›LMS API›External parties›List external parties

List external parties

GEThttps://sandbox.api.lendeasy.ai/v1/external-parties Bearer token · READ_LMS_EXTERNAL_PARTY

Lists counterparties by type, verification state, activation, and case-insensitive name search.

Request

curl https://sandbox.api.lendeasy.ai/v1/external-parties \
  -H "Authorization: Bearer $TOKEN"

await fetch(`https://sandbox.api.lendeasy.ai/v1/external-parties`, {
  method: "GET",
  headers: { Authorization: `Bearer ${token}` },
});

requests.get(
  f"https://sandbox.api.lendeasy.ai/v1/external-parties",
  headers={"Authorization": f"Bearer {token}"},
)

{
  "items": [
    {
      "partyId": 51,
      "partyType": "MERCHANT",
      "displayName": "Juniper Home Market",
      "legalName": "Juniper Home Market LLC",
      "externalReference": "merchant-2048",
      "active": true,
      "verificationState": "VERIFIED",
      "createdAt": "2026-08-01T12: 00:00Z",
      "lastModifiedAt": "2026-09-01T12: 00:00Z"
    }
  ]
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "400",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "validation.msg.validation.errors.exist",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "401",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authenticated",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "403",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authorized",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "404",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.resource.not.found",
  "errors": []
}

Path & query parameters

Field	Type	Description
LendEasy-Tenant required in header	string	Tenant selector: lowercase letters, digits, and hyphens, 1-64 characters. Exactly one instance; the only tenant selector honored.
active optional in query	boolean	Filter by activation.
partyType optional in query	string	Filter by party type. One of `MERCHANT · VENDOR · DEALER · SCHOOL · HEALTHCARE_PROVIDER · EMPLOYER · INVESTOR · OTHER`.
verificationState optional in query	string	Filter by verification state. One of `UNVERIFIED · VERIFIED · FAILED · UNDER_REVIEW`.
search optional in query	string	Case-insensitive substring match on display name.
limit optional in query	integer	Maximum records to return.
offset optional in query	integer	Zero-based offset into the result set.

Request

curl https://sandbox.api.lendeasy.ai/v1/external-parties \
  -H "Authorization: Bearer $TOKEN"

await fetch(`https://sandbox.api.lendeasy.ai/v1/external-parties`, {
  method: "GET",
  headers: { Authorization: `Bearer ${token}` },
});

requests.get(
  f"https://sandbox.api.lendeasy.ai/v1/external-parties",
  headers={"Authorization": f"Bearer {token}"},
)

{
  "items": [
    {
      "partyId": 51,
      "partyType": "MERCHANT",
      "displayName": "Juniper Home Market",
      "legalName": "Juniper Home Market LLC",
      "externalReference": "merchant-2048",
      "active": true,
      "verificationState": "VERIFIED",
      "createdAt": "2026-08-01T12: 00:00Z",
      "lastModifiedAt": "2026-09-01T12: 00:00Z"
    }
  ]
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "400",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "validation.msg.validation.errors.exist",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "401",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authenticated",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "403",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authorized",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "404",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.resource.not.found",
  "errors": []
}