Saltar al contenido 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"
}
Recupera el perfil completo de un representante empresarial único por su ID. La respuesta incluye los datos de contacto del representante, participación de propiedad, roles asignados y un desglose de sus criterios de verificación KYB — mostrando qué requisitos están completos, cuáles siguen siendo necesarios y cualquier error que deba resolverse antes de que el representante pueda ser aprobado.

Autorizaciones

​
Authorization
string
header
requerido

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

Parámetros de ruta

​
id
string
requerido

Business Representative ID

Minimum string length: 1
Ejemplo:

"associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b"

Respuesta

​
id
string
requerido

Business Representative ID

Ejemplo:

"associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b"

​
customerId
string
requerido

Customer ID

Ejemplo:

"customer_2f283221a9d44ada800ac7f11f640402"

​
type
enum<string>
requerido

Customer type

Opciones disponibles:
individual
Ejemplo:

"individual"

​
verificationProfiles
object[]
requerido

Array of verification profiles for the business representative.

Ejemplo:
[
  {
    "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
requerido

The date and time the business representative was created.

Ejemplo:

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

​
updatedAt
string
requerido

The date and time the business representative was last updated.

Ejemplo:

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

​
email
string

Email address

Ejemplo:

"james.wilson@acmecorp.example.com"

​
phone
string

Phone number

Ejemplo:

"+13125559876"

​
representationDetails
object

Representation details

Última modificación el 18 de junio de 2026