> ## Documentation Index > Fetch the complete documentation index at: https://docs.swipelux.com/llms.txt > Use this file to discover all available pages before exploring further. # Create related party > Creates a person or entity related party for a business customer. The party gets a stable rp_ id, requires at least one role or one ownership, voting, or control fact, and the parent customer's updatedAt advances in the same transaction. ## OpenAPI ````yaml /openapi.json post /v3/customers/{customerId}/related-parties openapi: 3.1.0 info: title: Swipelux API version: 3.1.0 servers: - url: https://platform.swipelux.com description: Production and sandbox; environment selected by API key security: - apiKey: [] tags: - name: customers x-displayName: Customers description: >- Create, list, update, export, and archive individual and business customers and their related parties. - name: capabilities x-displayName: Capabilities description: >- Discover, request, inspect, and cancel customer capabilities and their institution applications. - name: accounts x-displayName: Accounts description: Create, inspect, update, and archive customer accounts. - name: recipients x-displayName: Recipients description: Create third-party recipients and their payout destinations. - name: Tasks x-displayName: Tasks description: Inspect customer, capability, application, account, and transfer tasks. - name: Task submissions x-displayName: Task submissions description: Submit and inspect immutable answers to customer tasks. - name: documents x-displayName: Documents description: Upload and inspect customer documents used in task submissions. - name: money-movement x-displayName: Money movement description: Create quotes, execute quote-backed transfers, and inspect transfer state. - name: rules x-displayName: Rules description: >- Standing instructions that act on incoming funds. A rule watches a custodial wallet account (`trigger`) and, when funds become available on it, transfers them to a target (`action`) — most commonly a sweep to a non-custodial wallet destination. Rules match at the account credit, not at the deposit rail: fiat deposits settle into the issued bank account's settlement wallet account, so a rule on that wallet account catches ACH/SEPA/SWIFT deposits, stablecoin deposits, and internal transfers alike. The action target reuses the money-movement vocabulary (`account` for the customer's own accounts, `destination` for recipient destinations). At most one non-archived rule may watch a given trigger account. Statuses: `active ⇄ paused → archived` — pause and resume through PATCH, archive (terminal) through DELETE. - name: sandbox x-displayName: Sandbox description: Simulate supported account, task, capability, and transfer outcomes. - name: institutions x-displayName: Institutions description: List institutions referenced by capabilities and applications. - name: webhooks x-displayName: Webhooks description: Configure webhook endpoints and inspect delivery activity. externalDocs: description: Swipelux Documentation url: https://docs.swipelux.com paths: /v3/customers/{customerId}/related-parties: post: tags: - customers summary: Create related party description: >- Creates a person or entity related party for a business customer. The party gets a stable rp_ id, requires at least one role or one ownership, voting, or control fact, and the parent customer's updatedAt advances in the same transaction. operationId: postV3CustomersByCustomerIdRelated-parties parameters: - name: Idempotency-Key in: header required: true schema: type: string minLength: 1 maxLength: 255 example: idem_20260626_0001 description: >- Required for effectful v3 requests (POST, PATCH, PUT, DELETE). Reuse the same key with the same body to replay the cached response. - schema: type: string in: path name: customerId required: true requestBody: required: true content: application/json: schema: oneOf: - type: object required: - partyType - roles - person properties: partyType: type: string enum: - person roles: type: array uniqueItems: true items: type: string enum: - control_person - director - officer - authorized_signer - authorized_representative - compliance_officer - primary_contact - account_administrator - trustee - settlor - protector - beneficiary - general_partner - limited_partner - other roleDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. title: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. ownership: type: object minProperties: 1 properties: declared: type: boolean directPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ indirectPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ effectivePercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ votingRights: type: object minProperties: 1 properties: declared: type: boolean directPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ indirectPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ effectivePercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ control: type: object properties: declared: type: boolean direct: type: boolean indirect: type: boolean description: type: string minLength: 1 maxLength: 4096 description: >- Preserved narrative; line feed and tab are allowed and other controls are rejected. person: type: object properties: firstName: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. middleName: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. lastName: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. birthDate: type: string format: date birthCountry: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. nationalities: type: array uniqueItems: true items: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. residenceCountry: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. email: type: string format: email maxLength: 254 phone: type: string pattern: ^\+[1-9][0-9]{1,14}$ residentialAddress: type: object minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. mailingAddress: type: object minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. taxResidencies: type: array uniqueItems: true items: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. taxIdentifiers: type: array items: type: object required: - type - country - value properties: type: type: string enum: - ssn - itin - ein - tin - vat - cpf - cnpj - other typeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. value: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. description: >- Tax identifier. typeDescription is required and allowed only for type other. identityDocuments: type: array items: type: object required: - type - issuingCountry properties: type: type: string enum: - passport - national_id - drivers_license - residence_permit - government_id - state_or_provincial_id - other typeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. issuingCountry: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. issuingRegion: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. number: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. issuedOn: type: string format: date expiresOn: type: string format: date doesNotExpire: type: boolean description: >- Identity-document metadata; number is optional and expiry facts are mutually consistent. employment: type: object minProperties: 1 properties: status: type: string enum: - employed - self_employed - unemployed - student - retired - homemaker - other statusDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. occupation: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. description: >- Employment requires status or occupation; statusDescription is exclusive to other. description: >- Reusable progressively collected individual identity facts. - type: object required: - partyType - roles - entity properties: partyType: type: string enum: - entity roles: type: array uniqueItems: true items: type: string enum: - control_person - director - officer - authorized_signer - authorized_representative - compliance_officer - primary_contact - account_administrator - trustee - settlor - protector - beneficiary - general_partner - limited_partner - other roleDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. title: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. ownership: type: object minProperties: 1 properties: declared: type: boolean directPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ indirectPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ effectivePercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ votingRights: type: object minProperties: 1 properties: declared: type: boolean directPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ indirectPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ effectivePercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ control: type: object properties: declared: type: boolean direct: type: boolean indirect: type: boolean description: type: string minLength: 1 maxLength: 4096 description: >- Preserved narrative; line feed and tab are allowed and other controls are rejected. entity: type: object required: - legalName properties: legalName: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. tradeNames: type: array uniqueItems: true items: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. legalForm: type: string enum: - corporation - limited_liability_company - partnership - limited_partnership - sole_proprietorship - nonprofit - cooperative - association - professional_association - foundation - trust - investment_fund - society - dao - government_entity - other legalFormDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. email: type: string format: email maxLength: 254 complianceEmail: type: string format: email maxLength: 254 phone: type: string pattern: ^\+[1-9][0-9]{1,14}$ websites: type: array uniqueItems: true items: type: string format: uri maxLength: 2048 description: type: string minLength: 1 maxLength: 4096 description: >- Preserved narrative; line feed and tab are allowed and other controls are rejected. productsAndServices: type: string minLength: 1 maxLength: 4096 description: >- Preserved narrative; line feed and tab are allowed and other controls are rejected. industryClassifications: type: array items: type: object required: - scheme - code properties: scheme: type: string enum: - naics - sic - nace - isic - mcc - other schemeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. code: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. customerTypes: type: array uniqueItems: true items: type: string enum: - individual - business - financial_institution - government - nonprofit - other customerTypeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. salesChannels: type: array uniqueItems: true items: type: string enum: - online - in_person - marketplace - mobile_app - business_to_business - other salesChannelDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. registration: type: object minProperties: 1 properties: jurisdiction: type: object required: - country properties: country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. region: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. description: >- Country and optional country-specific registration region. number: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. formationDate: type: string format: date registeredAddress: type: object minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. operatingAddress: type: object minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. mailingAddress: type: object minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. operatingCountries: type: array uniqueItems: true items: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. taxResidencies: type: array uniqueItems: true items: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. taxIdentifiers: type: array items: type: object required: - type - country - value properties: type: type: string enum: - ssn - itin - ein - tin - vat - cpf - cnpj - other typeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. value: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. description: >- Tax identifier. typeDescription is required and allowed only for type other. publicListing: type: object minProperties: 1 properties: exchange: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. ticker: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. jurisdiction: type: object required: - country properties: country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. region: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. description: >- Country and optional country-specific registration region. regulatoryStatus: type: string enum: - regulated - pending - unregulated - exempt regulatoryRegistrations: type: array items: type: object required: - type - jurisdiction properties: type: type: string enum: - money_transmitter - money_services_business - bank - electronic_money_institution - payment_institution - virtual_asset_service_provider - broker_dealer - investment_adviser - lender - other typeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. jurisdiction: type: object required: - country properties: country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. region: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. description: >- Country and optional country-specific registration region. authority: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. number: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. status: type: string enum: - active - pending - suspended - revoked - expired issuedOn: type: string format: date expiresOn: type: string format: date description: >- Reusable business identity; legalName is the required anchor. discriminator: propertyName: partyType examples: personDirector: summary: Person director value: partyType: person roles: - director title: Chief executive officer person: firstName: Amina lastName: Diallo residenceCountry: FR responses: '201': description: Related party created headers: Idempotency-Replayed: description: >- Present with value `true` when an idempotent request is replayed. schema: type: string enum: - 'true' content: application/json: schema: type: object required: - data properties: data: $ref: '#/components/schemas/RelatedParty' examples: personDirector: summary: Created person director value: data: id: rp_01JDIRECTOR customerId: cus_01JBUSINESS partyType: person roles: - director title: Chief executive officer person: firstName: Amina lastName: Diallo residenceCountry: FR createdAt: '2026-07-15T18:20:00.000Z' updatedAt: '2026-07-15T18:20:00.000Z' '400': description: >- Invalid related-party body, wrong union field, or missing idempotency key. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - validation_error - invalid_field_for_type description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. '401': description: Authentication required. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. '403': description: Insufficient permissions. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. '404': description: Customer not found, foreign, or archived. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - customer_not_found description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. '409': description: Idempotency conflict or request in progress. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string enum: - idempotency_conflict - idempotency_request_in_progress description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. examples: requestInProgress: summary: An identical request is still in progress value: type: >- https://docs.swipelux.com/errors/idempotency-request-in-progress title: Idempotency Request In Progress status: 409 code: idempotency_request_in_progress detail: A request with this Idempotency-Key is still in progress. correlationId: 01JERRORIDEMPOTENCY retryable: true '500': description: Internal server error. content: application/problem+json: schema: type: object additionalProperties: false required: - type - title - status - code - detail - correlationId properties: type: type: string format: uri description: Documentation URL for this stable problem code. title: type: string description: Short human-readable problem title. status: type: integer minimum: 400 maximum: 599 description: HTTP status code. code: type: string description: Stable snake_case error code. detail: type: string description: Actionable problem detail for legitimate callers. correlationId: type: string description: Request correlation id. Mirrors `X-Request-Id`. transferId: type: string description: >- Existing transfer that consumed the quote. Present on `quote_already_executed`. retryable: type: boolean description: Whether retrying the same request may succeed. errors: type: array description: Field-level validation errors. items: type: object additionalProperties: false required: - pointer - code - message properties: pointer: type: string description: JSON Pointer into the request body. code: type: string description: Machine-readable field error code. message: type: string description: Human-readable field error message. statusReason: type: object description: >- Structured reason for a state conflict when the failed operation depends on the resource's current status. required: - code - message - actor - retryable properties: code: type: string description: >- Stable snake_case reason code from the documented catalog. example: sanctions_screening_failed message: type: string description: Human-readable explanation of the current status. actor: type: string enum: - customer - developer - provider - network - swipelux description: >- Party whose action moves the resource forward: the end customer, the developer integrating the API, the underlying provider, payment network or rail, or Swipelux. Closed enum — exhaustive; additions would be a breaking change. retryable: type: boolean description: >- Whether retrying the blocked operation without changing its inputs or state may succeed. reviewAnswer: type: string nullable: true description: Verification review answer when supplied by the verifier. capabilities: type: array minItems: 1 items: type: string description: Capability ids that satisfy the failed operation. blockingResources: type: array minItems: 1 description: >- Customer resources that must be resolved before the requested operation can proceed, sorted by type and id. items: type: object additionalProperties: false required: - type - id - requiredAction properties: type: type: string enum: - account - transfer id: type: string description: Public id of the blocking resource. requiredAction: type: string enum: - archive_account - cancel_transfer - wait_for_transfer - resolve_transfer description: Next action required before retrying the operation. components: schemas: RelatedParty: oneOf: - type: object additionalProperties: false required: - id - customerId - partyType - roles - person - createdAt - updatedAt properties: partyType: type: string enum: - person roles: type: array uniqueItems: true items: type: string enum: - control_person - director - officer - authorized_signer - authorized_representative - compliance_officer - primary_contact - account_administrator - trustee - settlor - protector - beneficiary - general_partner - limited_partner - other roleDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. title: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. ownership: type: object additionalProperties: false minProperties: 1 properties: declared: type: boolean directPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ indirectPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ effectivePercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ votingRights: type: object additionalProperties: false minProperties: 1 properties: declared: type: boolean directPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ indirectPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ effectivePercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ control: type: object additionalProperties: false properties: declared: type: boolean direct: type: boolean indirect: type: boolean description: type: string minLength: 1 maxLength: 4096 description: >- Preserved narrative; line feed and tab are allowed and other controls are rejected. person: type: object additionalProperties: false properties: firstName: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. middleName: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. lastName: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. birthDate: type: string format: date birthCountry: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. nationalities: type: array uniqueItems: true items: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. residenceCountry: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. email: type: string format: email maxLength: 254 phone: type: string pattern: ^\+[1-9][0-9]{1,14}$ residentialAddress: type: object additionalProperties: false minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. mailingAddress: type: object additionalProperties: false minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. taxResidencies: type: array uniqueItems: true items: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. taxIdentifiers: type: array items: type: object additionalProperties: false required: - type - country - value properties: type: type: string enum: - ssn - itin - ein - tin - vat - cpf - cnpj - other typeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. value: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. description: >- Tax identifier. typeDescription is required and allowed only for type other. identityDocuments: type: array items: type: object additionalProperties: false required: - type - issuingCountry properties: type: type: string enum: - passport - national_id - drivers_license - residence_permit - government_id - state_or_provincial_id - other typeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. issuingCountry: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. issuingRegion: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. number: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. issuedOn: type: string format: date expiresOn: type: string format: date doesNotExpire: type: boolean description: >- Identity-document metadata; number is optional and expiry facts are mutually consistent. employment: type: object additionalProperties: false minProperties: 1 properties: status: type: string enum: - employed - self_employed - unemployed - student - retired - homemaker - other statusDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. occupation: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. description: >- Employment requires status or occupation; statusDescription is exclusive to other. description: Reusable progressively collected individual identity facts. id: type: string pattern: ^rp_[0-9A-Za-z]+$ example: rp_5rW7cQvGWX0altPGIqM6O customerId: type: string pattern: ^cus_[0-9A-Za-z]+$ createdAt: type: string format: date-time updatedAt: type: string format: date-time - type: object additionalProperties: false required: - id - customerId - partyType - roles - entity - createdAt - updatedAt properties: partyType: type: string enum: - entity roles: type: array uniqueItems: true items: type: string enum: - control_person - director - officer - authorized_signer - authorized_representative - compliance_officer - primary_contact - account_administrator - trustee - settlor - protector - beneficiary - general_partner - limited_partner - other roleDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. title: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. ownership: type: object additionalProperties: false minProperties: 1 properties: declared: type: boolean directPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ indirectPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ effectivePercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ votingRights: type: object additionalProperties: false minProperties: 1 properties: declared: type: boolean directPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ indirectPercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ effectivePercentage: type: string pattern: ^(?:(?:0|[1-9][0-9]?)(?:\.[0-9]+)?|100(?:\.0+)?)$ control: type: object additionalProperties: false properties: declared: type: boolean direct: type: boolean indirect: type: boolean description: type: string minLength: 1 maxLength: 4096 description: >- Preserved narrative; line feed and tab are allowed and other controls are rejected. entity: type: object additionalProperties: false required: - legalName properties: legalName: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. tradeNames: type: array uniqueItems: true items: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. legalForm: type: string enum: - corporation - limited_liability_company - partnership - limited_partnership - sole_proprietorship - nonprofit - cooperative - association - professional_association - foundation - trust - investment_fund - society - dao - government_entity - other legalFormDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. email: type: string format: email maxLength: 254 complianceEmail: type: string format: email maxLength: 254 phone: type: string pattern: ^\+[1-9][0-9]{1,14}$ websites: type: array uniqueItems: true items: type: string format: uri maxLength: 2048 description: type: string minLength: 1 maxLength: 4096 description: >- Preserved narrative; line feed and tab are allowed and other controls are rejected. productsAndServices: type: string minLength: 1 maxLength: 4096 description: >- Preserved narrative; line feed and tab are allowed and other controls are rejected. industryClassifications: type: array items: type: object additionalProperties: false required: - scheme - code properties: scheme: type: string enum: - naics - sic - nace - isic - mcc - other schemeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. code: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. customerTypes: type: array uniqueItems: true items: type: string enum: - individual - business - financial_institution - government - nonprofit - other customerTypeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. salesChannels: type: array uniqueItems: true items: type: string enum: - online - in_person - marketplace - mobile_app - business_to_business - other salesChannelDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. registration: type: object additionalProperties: false minProperties: 1 properties: jurisdiction: type: object additionalProperties: false required: - country properties: country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. region: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. description: >- Country and optional country-specific registration region. number: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. formationDate: type: string format: date registeredAddress: type: object additionalProperties: false minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. operatingAddress: type: object additionalProperties: false minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. mailingAddress: type: object additionalProperties: false minProperties: 1 properties: streetLine1: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. streetLine2: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. city: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. state: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. postalCode: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. description: >- Progressively collected address with at least one supplied fact. operatingCountries: type: array uniqueItems: true items: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. taxResidencies: type: array uniqueItems: true items: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. taxIdentifiers: type: array items: type: object additionalProperties: false required: - type - country - value properties: type: type: string enum: - ssn - itin - ein - tin - vat - cpf - cnpj - other typeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. value: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. description: >- Tax identifier. typeDescription is required and allowed only for type other. publicListing: type: object additionalProperties: false minProperties: 1 properties: exchange: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. ticker: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. jurisdiction: type: object additionalProperties: false required: - country properties: country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. region: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. description: >- Country and optional country-specific registration region. regulatoryStatus: type: string enum: - regulated - pending - unregulated - exempt regulatoryRegistrations: type: array items: type: object additionalProperties: false required: - type - jurisdiction properties: type: type: string enum: - money_transmitter - money_services_business - bank - electronic_money_institution - payment_institution - virtual_asset_service_provider - broker_dealer - investment_adviser - lender - other typeDescription: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. jurisdiction: type: object additionalProperties: false required: - country properties: country: type: string pattern: ^[A-Z]{2}$ minLength: 2 maxLength: 2 description: ISO 3166-1 alpha-2 country code. region: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. description: >- Country and optional country-specific registration region. authority: type: string minLength: 1 maxLength: 256 description: >- Preserved exactly; leading/trailing whitespace and control characters are rejected. number: type: string minLength: 1 maxLength: 256 description: >- Identifier preserved exactly, without leading/trailing whitespace or controls. status: type: string enum: - active - pending - suspended - revoked - expired issuedOn: type: string format: date expiresOn: type: string format: date description: Reusable business identity; legalName is the required anchor. id: type: string pattern: ^rp_[0-9A-Za-z]+$ example: rp_5rW7cQvGWX0altPGIqM6O customerId: type: string pattern: ^cus_[0-9A-Za-z]+$ createdAt: type: string format: date-time updatedAt: type: string format: date-time discriminator: propertyName: partyType securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: Your Swipelux API key. Obtain this from the Swipelux Dashboard. ```` ## Related topics - [Get related party](/api-reference/customers/get-v3-customers-by-customer-id-related-parties-by-related-party-id.md) - [Archive related party](/api-reference/customers/delete-v3-customers-by-customer-id-related-parties-by-related-party-id.md) - [List related parties](/api-reference/customers/get-v3-customers-by-customer-id-related-parties.md) - [Update related party](/api-reference/customers/patch-v3-customers-by-customer-id-related-parties-by-related-party-id.md) - [KYB workflow](/knowledge-base/business-onboarding/kyb-workflow.md)