Pular para o conteúdo principal
Get a Business Representative by ID
curl --request GET \
  --url https://api.spherepay.co/v2/business-representative/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b",
  "customerId": "customer_2f283221a9d44ada800ac7f11f640402",
  "type": "individual",
  "email": "james.wilson@acmecorp.example.com",
  "phone": "+13125559876",
  "representationDetails": {
    "roles": [
      "ubo"
    ],
    "ownershipPercentage": "50",
    "isControlPerson": true,
    "isSigner": true,
    "relationshipEstablishedAt": "2020-03-15",
    "title": "CEO"
  },
  "verificationProfiles": [
    {
      "name": "ubo_kyc_profile_a",
      "status": "incomplete",
      "criteria": {
        "complete": [
          "email_address",
          "phone_number",
          "residential_address",
          "tax_identification_number",
          "ownership_percentage",
          "is_control_person",
          "is_signer",
          "relationship_established_at",
          "title"
        ],
        "pending": [],
        "required": [
          "identity_document",
          "liveness_report_document",
          "proof_of_address_document"
        ],
        "errors": []
      }
    }
  ],
  "createdAt": "2026-03-10T00:00:08.986Z",
  "updatedAt": "2026-03-10T00:00:08.986Z"
}
Recupere o perfil completo de um único representante empresarial pelo seu ID. A resposta inclui os detalhes de contato, participação acionária, papéis atribuídos e um detalhamento dos critérios de verificação KYB do representante — mostrando quais requisitos estão completos, quais ainda são necessários e quaisquer erros que precisam ser resolvidos antes que o representante possa ser aprovado.

Autorizações

​
Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

​
id
string
obrigatório

Business Representative ID

Minimum string length: 1
Exemplo:

"associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b"

Resposta

​
id
string
obrigatório

Business Representative ID

Exemplo:

"associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b"

​
customerId
string
obrigatório

Customer ID

Exemplo:

"customer_2f283221a9d44ada800ac7f11f640402"

​
type
enum<string>
obrigatório

Customer type

Opções disponíveis:
individual
Exemplo:

"individual"

​
verificationProfiles
object[]
obrigatório

Array of verification profiles for the business representative.

Exemplo:
[
  {
    "name": "ubo_kyc_profile_a",
    "status": "incomplete",
    "criteria": {
      "complete": [
        "email_address",
        "phone_number",
        "residential_address",
        "tax_identification_number",
        "ownership_percentage",
        "is_control_person",
        "is_signer",
        "relationship_established_at",
        "title"
      ],
      "pending": [],
      "required": [
        "identity_document",
        "liveness_report_document",
        "proof_of_address_document"
      ],
      "errors": []
    }
  }
]
​
createdAt
string
obrigatório

The date and time the business representative was created.

Exemplo:

"2026-03-10T00:00:08.986Z"

​
updatedAt
string
obrigatório

The date and time the business representative was last updated.

Exemplo:

"2026-03-10T00:00:08.986Z"

​
email
string

Email address

Exemplo:

"james.wilson@acmecorp.example.com"

​
phone
string

Phone number

Exemplo:

"+13125559876"

​
representationDetails
object

Representation details

Última modificação em 18 de junho de 2026