> ## Documentation Index > Fetch the complete documentation index at: https://docs.mesadepagos.com/llms.txt > Use this file to discover all available pages before exploring further. # Request client endorsements > Determines and requests the endorsements needed for the client to collect in their own name. Idempotent. The body is optional; omitting it requests all currencies. ## OpenAPI ````yaml /openapi-v2.en.yaml post /v2/business-clients/{clientId}/endorsements openapi: 3.0.0 info: title: YP API Partner description: Integration documentation for YP API partners. version: v2 contact: {} servers: - url: https://sandbox-rampa.mesadepagos.com/api description: Sandbox security: [] tags: - name: Auth description: '' - name: Quotes description: '' - name: Payin description: '' - name: Payout description: '' - name: Wallet description: '' - name: Queries description: '' - name: Webhooks description: '' - name: Fees description: '' - name: Clients description: '' - name: Client verifications description: Las verificaciones que habilitan a un cliente a cobrar a su nombre. - name: Virtual accounts description: 'Las cuentas de cobro: las del partner y las de sus clientes.' paths: /v2/business-clients/{clientId}/endorsements: post: tags: - Client verifications summary: Request client endorsements description: >- Determines and requests the endorsements needed for the client to collect in their own name. Idempotent. The body is optional; omitting it requests all currencies. operationId: requestEndorsements parameters: - name: clientId required: true in: path description: Client identifier. schema: format: uuid example: 550e8400-e29b-41d4-a716-446655440000 type: string requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/RequestEndorsementsRequestDoc' responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/RequestEndorsementsResponseDoc' '400': description: '' content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponseDoc' '401': description: '' content: application/json: schema: $ref: '#/components/schemas/UnauthorizedResponseDoc' '404': description: The client does not exist or does not belong to the partner. content: application/json: schema: $ref: '#/components/schemas/NotFoundResponseDoc' security: - bearer: [] components: schemas: RequestEndorsementsRequestDoc: type: object properties: currencies: type: array minItems: 1 example: - EUR - USD description: >- Currencies to enable. Omitting this field requests all. Limit the selection because each endorsement may require a person to complete additional details. items: type: string enum: - EUR - USD - AED - AUD - GBP RequestEndorsementsResponseDoc: type: object properties: endorsements: type: array items: $ref: '#/components/schemas/EndorsementDoc' failed: description: >- Currencies that could not be enabled. Empty on success. Listed currencies require further action. type: array items: $ref: '#/components/schemas/FailedEndorsementDoc' required: - endorsements - failed ValidationErrorResponseDoc: type: object properties: statusCode: type: number example: 400 message: type: string example: Validation failed error: type: string example: Bad Request required: - statusCode - message - error UnauthorizedResponseDoc: type: object properties: statusCode: type: number example: 401 message: type: string example: Unauthorized required: - statusCode - message NotFoundResponseDoc: type: object properties: statusCode: type: number example: 404 message: type: string example: Endorsement subject not found required: - statusCode - message EndorsementDoc: type: object properties: currencies: example: - EUR description: >- Currencies this endorsement enables the client to collect in their own name. type: array items: type: string status: type: string enum: - pending - dataRequired - inProgress - inReview - approved - rejected example: dataRequired description: '`dataRequired` means a subject has pending details.' requestedAt: type: string example: '2026-09-16T12:00:00.000Z' nullable: true format: date-time resolvedAt: type: string example: null nullable: true format: date-time description: Set when the endorsement is approved or rejected. rejectionReason: type: string example: null nullable: true subjects: description: >- An endorsement can involve several subjects: the company and each partner or director. Each completes their details separately. type: array items: $ref: '#/components/schemas/EndorsementSubjectDoc' required: - currencies - status - requestedAt - resolvedAt - rejectionReason - subjects FailedEndorsementDoc: type: object properties: currencies: example: - EUR type: array items: type: string reason: type: string enum: - termsNotAccepted - verificationNotApproved - notAvailableForAccountType - alreadyRequested - unavailable example: termsNotAccepted description: Reason this currency could not be enabled. required: - currencies - reason EndorsementSubjectDoc: type: object properties: id: type: string example: 2363e78c-163b-4ff9-a25c-dfcc71d56c08 format: uuid description: Subject identifier used to request their link. name: type: string example: Acme Bolivia SRL nullable: true description: Subject name used to identify who should receive each link. type: type: string example: individual enum: - business - individual description: 'The company or an individual: a partner, director, or owner.' isPrimary: type: boolean example: true description: True when the subject is the company. status: type: string enum: - pending - inReview - approved - rejected example: pending description: '`pending` when details remain to be completed.' pending: $ref: '#/components/schemas/PendingRequirementsDoc' linkIssuedAt: type: string example: '2026-09-16T12:00:00.000Z' nullable: true format: date-time description: When the latest link was issued. Null if no link was requested. required: - id - name - type - isPrimary - status - pending - linkIssuedAt PendingRequirementsDoc: type: object properties: fields: example: - birthCountry - address description: Fields that this subject still needs to complete. type: array items: type: string documents: example: - ID description: Document categories that this subject must upload. type: array items: type: string required: - fields - documents securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http description: JWT obtained from /v2/auth/login or /v3/auth/login ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.