Skip to main content

Get legal representative liveness links

GET 
/v1/users/onboardings/:id/legal-representatives/liveness

Lists every legal representative of the onboarding with the individual liveness link already created for them. A representative whose link does not exist yet is returned without url, so the caller can tell who is still pending.

Request​

Path Parameters

    id stringrequired

    Legal person onboarding ID.

Header Parameters

    nonce stringrequired

    The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

    x-product-uuid string

    UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.

    x-product-target-user-uuid string

    UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.

    x-lang string

    Possible values: [pt-BR, en-US]

    Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

Responses​

Legal representative liveness links retrieved.

Schema
  • Array [
    • id stringrequired

    Legal representative ID.

    name stringrequired

    Legal representative name.

    url string

    Individual liveness link. Absent while the link has not been created yet for this representative.

    status stringrequired

    Possible values: [PENDING, WAITING_SUBMISSION, IN_ANALYSIS, APPROVED]

    Liveness progress of this representative:

    • PENDING: link not created yet for this representative.
    • WAITING_SUBMISSION: link issued, the representative has not done the liveness.
    • IN_ANALYSIS: submitted, under analysis.
    • APPROVED: done.

    submitted_at date-time

    When this representative submitted the liveness. Absent while nothing was submitted.

  • ]
Loading...