List signatories for a customer

Returns signatories for the customer. Supports paging and optional ordering (passed through to the legal-entity service).

Access and authorization

  • The caller's partner identifier must be present (SIG_PARTNERID_REQUIRED if missing).
  • The requested customer must exist (SIG_CUSTOMER_NOTFOUND) and be allowed for the caller's token (SIG_CUSTOMERACCESS_DENIED).

Validation

  • Query parameters such as page and size must remain within supported ranges when provided; invalid path or query values can yield SIG_VALIDATION_ERROR.

When no rows exist, HTTP 200 still returns with an empty signatories array and an empty-state message.

SecurityoAuth2
Request
path Parameters
customerId
required
integer <int64> >= 1

Customer (legal entity) identifier used on the public Open Banking surface.

query Parameters
page
integer [ 0 .. 9999 ]
Default: 0

Zero-based page index.

size
integer [ 1 .. 500 ]
Default: 10

Page size.

Responses
200

List result (may be empty)

400

HTTP 400 — Bad Request

This response is returned when the request is invalid or cannot be processed.

The response includes a list of errors, where each error contains:

  • code: A unique identifier for the error
  • message: A description of the issue

Possible reasons include:

  • Missing or invalid input values
  • Incorrect request format
  • Invalid email or phone number
  • Invalid approval limit values
  • Missing required identifiers
  • Customer not found or access not allowed
  • Issues while processing the request

Common error codes: SIG_FULLNAME_REQUIRED, SIG_EMAIL_REQUIRED, SIG_EMAIL_INVALID, SIG_PHONE_REQUIRED, SIG_PHONE_INVALID, SIG_APPROVALLIMIT_MIN, SIG_APPROVALLIMIT_INVALID, SIG_PARTNERID_REQUIRED, SIG_CUSTOMER_NOTFOUND, SIG_CUSTOMERACCESS_DENIED, SIG_VALIDATION_ERROR, SIG_SERVICECALL_FAILED, SIG_SIGNATORYNOTFOUND, PHONE_SERVICECALL_FAILED

Note:

  • Some scenarios such as "not found" or "access denied" may still return HTTP 400.
401

HTTP 401 — Unauthorized

This response is returned when authentication is missing or invalid.

The response includes:

  • code: A standard error identifier
  • message: A message indicating that authorization is required
403

HTTP 403 — Forbidden

This response is returned when the request is understood but not allowed.

The response includes:

  • code: A standard error identifier
  • message: A message indicating that access is denied

Note:

  • This is different from request validation errors, which return HTTP 400.
500

HTTP 500 — Internal Server Error

This response is returned when an unexpected error occurs while processing the request.

The response includes:

  • code: A standard error identifier
  • message: A general message describing the failure

Note:

  • Errors related to invalid input or request data will return HTTP 400, not 500.
get/v1/customers/{customerId}/signatories
Request samples 
Response samples 
application/json
{
  • "signatories": [
    ],
  • "message": "Signatories fetched successfully."
}