Issuer Representatives Registration

This endpoint allows registering representatives associated with a previously registered issuer.

Request

ENDPOINT

/issuer_management/issuer/ISSUER-KEY/issuer_representative

METHOD

POST

Path Params

Field	Type	Description	Characters
`ISSUER-KEY`	string	Unique issuer key (UUID v4).	36

Request Body

Request Body

{
  "name": "João da Silva",
  "document_number": "123.456.789-01",
  "birthdate": "1990-01-01",
  "nationality": "BRA",
  "mother_name": "Maria da Silva",
  "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
  },
  "related_party_type": "attorney",
  "annual_revenues": 150000,
}

Request Body Params

Field	Type	Description	Max Characters
`name` *	string	Full name of the issuer representative.	255
`document_number` *	string	Document number (CPF, format "XXX.XXX.XXX-XX").	11
`birthdate`	string	Representative's birthdate in ISO 8601 format (YYYY-MM-DD).	-
`document_identification_number`	string	Document identification number.	255
`marital_status`	string	Representative's marital status.	marital_status Enumerators
`property_system`	string	Property regime.	property_system Enumerators
`nationality` *	string	Beneficiary's country of origin.	3, according to ISO 3166-1 alpha-3
`mother_name`	string	Full name of the representative's mother.	1023
`father_name`	string	Full name of the representative's father.	1023
`occupation`	string	Representative's occupation or profession.	255
`is_pep`	boolean	Indicates if the representative is a Politically Exposed Person (PEP).	-
`address` *	string	Object referencing the address	Address Object
`annual_revenues`	number	Annual revenue declaration of the assignor.	-
`related_party_type` *	enumerator	Related party relationship type.	See Related Party Type Enumerators

Address Object

Field	Type	Description	Max Characters
`street` *	string	Street name of the company address.	500
`neighborhood`	string	Neighborhood name of the company address.	100
`number` *	string	Address number.	10
`postal_code` *	string	Address postal code (format "XXXXX-XXX").	8
`city` *	string	City name of the address.	255
`state` *	string	State abbreviation (2 characters).	2
`complement`	string	Address complement, if applicable.	100

marital_status Enumerators

Enum	Description
`single`	Single
`married`	Married
`widower`	Widowed
`separated`	Separated
`stable_union`	In Stable Union
`divorced`	Divorced

property_system Enumerators

Enum	Description
`total_communion_of_goods`	Total Community of Property
`partial_communion_of_goods`	Partial Community of Property
`total_separation_of_goods`	Total Separation of Property
`final_participation_of_acquisitions`	Final Participation in Acquisitions
`compulsory_separation_of_goods`	Compulsory Separation of Property

Enumerator	Description
president	President
partner	Partner
administrator	Administrator
director	Director
manager	Manager
attorney	Attorney

Response

STATUS

201

Response Body

{
  "issuer_representative_key": "123e4567-e89b-12d3-a456-426614174000",
  "name": "João da Silva",
  "document_number": "123.456.789-01",
  "document_identification_number": "987654321",
  "marital_status": "single",
  "property_system": "partial_communion_of_goods",
  "birthdate": "1990-01-01",
  "nationality": "BRA",
  "mother_name": "Maria da Silva",
  "father_name": "José da Silva",
  "occupation": "Advogado",
  "is_pep": false,
  "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
  },
  "related_party_type": "attorney",
  "annual_revenues": 150000,
  "issuer_representative_document_list": []
}

Response Body Params

Field	Type	Description	Max Characters
`issuer_representative_key`	string	Unique identifier for the issuer representative (UUID v4).	36
`name`	string	Full name of the issuer representative.	255
`document_number`	string	Representative's document number (format "XXX.XXX.XXX-XX").	11
`document_identification_number`	string	Document identification number.	255
`marital_status`	string	Representative's marital status.	marital_status Enumerators
`property_system`	string	Property regime.	property_system Enumerators
`birthdate`	string	Representative's birthdate.	-
`nationality` *	string	Beneficiary's country of origin.	3, according to ISO 3166-1 alpha-3
`mother_name`	string	Full name of the representative's mother.	1023
`father_name`	string	Full name of the representative's father.	1023
`occupation`	string	Representative's occupation or profession.	255
`is_pep`	boolean	Indicates if the representative is a Politically Exposed Person (PEP).	-
`address` *	string	Object referencing the address	Address Object
`issuer_representative_document_list`	array	List of documents associated with the representative.	-
`annual_revenues`	number	Annual revenue declaration of the assignor.	-
`related_party_type` *	enumerator	Related party relationship type.	See Related Party Type Enumerators

Issuer Representatives Registration

Request​

Path Params​

Request Body​

Request Body Params​

Address Object​

marital_status Enumerators​

property_system Enumerators​

Related Party Type​

Response​

Response Body Params​