​
Request Errors

The request to the /entities/:ent_id endpoint failed. These are the sub_type that can be returned.

​
INVALID_REQUEST

The request body failed basic validation for the specific API endpoint.

​
NOT_FOUND

The requested resource does not exist.

​
DUPLICATE_ENTITY_DETAILS

An Entity with the same details already exists.

​
INVALID_ENTITY_PHONE_NUMBER

The provided phone number is not a valid US phone number.

​
INVALID_ENTITY_EMAIL_ADDRESS

The provided email address is not a valid email address.

​
RESTRICTED_ENTITY_DETAILS

The Entity’s information does not match the restrictions set for your organization.

Consent for this Entity has already been withdrawn.

Consent for this entity has already been granted.

​
ENTITY_HAS_PAYMENTS_IN_PROGRESS

Consent for this entity cannot be withdrawn as it has one or more associated payments in progress.

​
ENTITY_INVALID_SSN

The provided SSN is invalid. Verify your request and try again.

​
ENTITY_INVALID_SSN4

The provided SSN4 is invalid. Verify your request and try again.

​
ENTITY_CREDIT_SCORE_NOT_FOUND

The credit score for this entity could not be found.

​
MAX_ENTITY_METADATA_SIZE_EXCEEDED

The max metadata object size of 1KB was exceeded.

​
ENTITY_UPDATE_RESTRICTED

Only Entity’s that have consented can be updated.

​
ENTITY_UPDATE_DISABLED

Disabled Entities cannot be updated.

​
ENTITY_UPDATE_INVALID

Cannot update an Entity’s field that has already been set.

​
ENTITY_UPDATE_UNSUPPORTED

This Entity cannot be updated.

​
Resource Errors

Errors set on an Entity’s error property for processes that are unsuccessful.

​
12001 – ENTITY_UNAUTHORIZED_PAYMENT

The Entity was disabled due to unauthorized payments which was reported by the FI.

​
Causes

{
  "type": "ENTITY_DISABLED",
  "code": 12001,
  "sub_type": "ENTITY_UNAUTHORIZED_PAYMENT",
  "message": "Entity was disabled due to a payment reported as unauthorized by the financial institution."
}

​
Resolution

The Entity will be disabled and all its capabilities will be removed.

​
12002 – ENTITY_INVALID_DETAILS

The Entity was disabled due to the information provided being invalid.

​
Causes

  • One or more PIIs provided were invalid.
{
  "type": "ENTITY_DISABLED",
  "code": 12002,
  "sub_type": "ENTITY_INVALID_DETAILS",
  "message": "Entity was disabled due to invalid information."
}

​
Resolution

The Entity will be disabled and no capabilities will be granted.

​
12003 – ENTITY_PENDING_KYC_REVIEW

The Entity was disabled due Method’s provider needing to review the Entity’s KYC information.

​
Causes

  • The Entity has been flagged for requiring a KYC review.
{
  "type": "ENTITY_DISABLED",
  "code": 12003,
  "sub_type": "ENTITY_PENDING_KYC_REVIEW",
  "message": "Entity was disabled due to pending KYC review."
}

​
Resolution

The Entity will be disabled and no capabilities will be granted.

​
12004 – ENTITY_SSN_MISMATCH

The Entity was disabled due to the PII provided not matching the identity the SSN belongs to.

​
Causes

  • SSN provided does not match the Entity’s identity.
{
  "type": "ENTITY_DISABLED",
  "code": 12004,
  "sub_type": "ENTITY_SSN_MISMATCH",
  "message": "Entity was disabled due to a mismatch in the provided and retrieved social security number."
}

​
Resolution

The Entity will be disabled and no capabilities will be granted.

The Entity was disabled due to consent being withdrawn.

​
Causes

  • The Entity has withdrawn consent.
{
  "type": "ENTITY_DISABLED",
  "code": 12005,
  "sub_type": "ENTITY_CONSENT_WITHDRAWN",
  "message": "Entity was disabled due to consent withdrawal."
}

​
Resolution

The Entity will be disabled and all its capabilities will be removed.

Resource ErrorsEntity Verification Session Errors