Request registration of an indirect participant
Opens a reda.014 (PtyCreReq) asking the SPI to record this rail as the indirect participant’s liquidante. The participant is created PENDING and stays there: only the BACEN reda.016 COMP advice makes it ACTIVE, and only an ACTIVE indirect has its arriving Pix settled here. A body naming a DIRECT participant is refused — the rail’s own identity is established on the admin route POST /api/v1/core/participants/direct.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Idempotency key, max 255 characters
Body
14-char CNPJ (alphanumeric per PICnpj [0-9A-Z]{12}[0-9]{2}) of the indirect participant; required for INDIRECT registration (rides the reda.014 MktSpcfcAttr CNPJIDRT).
14^[0-9A-Z]{12}[0-9]{2}$"12345678000199"
Lower-case e-mail BACEN uses to reach this participant about a funds-recovery case (DICT 2.12.1 Email pattern). The address must be lower-case: an upper-case one is refused, never rewritten. The service checks the format, not the published schema, so a refusal never echoes the submitted value back.
"med@bancoexemplo.com.br"
E.164 phone BACEN uses to reach this participant about a funds-recovery case (DICT 2.12.1 Phone pattern: +, then 2 to 15 digits). The service checks the format, not the published schema, so a refusal never echoes the submitted value back.
"+5511999998888"
ISPB of the participant, exactly 8 numeric digits.
^[0-9]{8}$"12345678"
Legal name of the participant institution. The 256-character bound is Lerian's own — it is what participants.name stores — not a BACEN limit.
1 - 256"Banco Exemplo S.A."
ISPB of the sponsoring participant (8 numeric digits); required for INDIRECT.
^[0-9]{8}$"87654321"
Connection type; must be INDIRECT. A direct participant is registered on the admin route POST /api/v1/core/participants/direct.
INDIRECT "INDIRECT"
Quota and routing configuration; supplied only for indirect participants.
Response
Created
Registered regulator-facing e-mail; travels on every MED 2.0 funds recovery opened for this participant.
"med@bancoexemplo.com.br"
Registered regulator-facing phone; travels on every MED 2.0 funds recovery opened for this participant.
"+5511999998888"
UTC timestamp when the participant was created, RFC 3339 format.
"2025-03-07T14:30:00Z"
Server-assigned UUID of the participant.
"550e8400-e29b-41d4-a716-446655440000"
ISPB of the participant, exactly 8 numeric digits.
"12345678"
Legal name of the participant institution.
"Banco Exemplo S.A."
Lifecycle state of the participant: ACTIVE, SUSPENDED, OFFBOARDED, PENDING (indirect reda.014 in flight), REGISTRATION_REJECTED (reda.016 REJT), or OFFBOARD_PENDING (reda.031 in flight).
"ACTIVE"
Connection type: DIRECT (connects directly to BACEN) or INDIRECT (routes through a sponsor).
"DIRECT"
UTC timestamp of the last update to the participant, RFC 3339 format.
"2025-03-07T14:30:00Z"
Quota and routing configuration; present only for indirect participants.
ISPB of the sponsoring participant (8 numeric digits); present only for INDIRECT participants.
""

