Lean Technologies Payment Destination API

The Payment Destination API from Lean Technologies — 3 operation(s) for payment destination.

Operations 4

POST /payments/v1/destinations Create Payment Destination #
GET /payments/v1/destinations List Payment Destinations #
GET /payments/v1/destinations/{payment_destination_id} Get Payment Destination by ID #
GET /customers/v1/{customer_id}/destinations Get Payment Destinations for Customer #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/lean-technologies-payment-destination-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lean-technologies-payment-destination-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Lean Technologies Payment Destination API
  version: '1.0'
  description: 'Operations tagged Payment Destination across 3 of this provider''s published API definitions: lean-technologies-payments-core-openapi.yml, lean-technologies-payments-customers-openapi.yml, lean-technologies-payments-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://sandbox.leantech.me
  description: Sandbox
- url: https://api2.leantech.me
  description: Production
tags:
- name: Payment Destination
  x-displayName: Payment Destination
paths:
  /payments/v1/destinations:
    post:
      operationId: createPaymentDestination
      summary: Create Payment Destination
      description: A Payment Destination defines the account for a Payment Intent to make payments into. Payment Destinations are used to create Beneficiaries in a user's Bank Account using the `.connect()` or `.createBeneficiary()` methods in the LinkSDK
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                branch_address:
                  description: The address of the branch that holds the account - required for all beneficiaries outside of ARE. This should be a single string with commas separating lines.
                  type: string
                name:
                  description: The name of the legal entity that owns the account.
                  type: string
                iban:
                  description: 'The IBAN of the account.

                    This is required for all countries except for the US.'
                  type: string
                display_name:
                  description: The friendly display name for the account. This is rendered in the LinkSDK when referencing the Destination.
                  type: string
                address:
                  description: The address of the owner of the destination bank account has registered with the bank.
                  type: string
                city:
                  description: The city that the holding financial institution is located in.
                  type: string
                country:
                  description: The three letter ISO code for the holding financial institution's country.
                  type: string
                swift_code:
                  description: The SWIFT Code for the bank account - required for most international destinations
                  type: string
                account_number:
                  description: The account number for the account.
                  type: string
                customer_id:
                  description: The Customer object associated with this account. This field is optional, and will designate the Destination as owned by the application if not provided.
                  type: string
                ifsc:
                  description: The IFSC number for the bank account - required for international destinations in India.
                  type: string
                transit_number:
                  description: The Transit Number for the bank account - required for international destinations in Canada
                  type: string
                sort_code:
                  description: The Sort Code for the bank account - required for international destinations in the UK
                  type: string
                routing_number:
                  description: The Routing Number for the bank account - required for international destinations in the US.
                  type: string
                postal_code:
                  description: The Postal Code of the owner of the destination bank account has registered with the bank - required for international destinations in the UK or the US
                  type: string
                currency:
                  description: The currency of the destination bank account - required for international destinations in the UK or the US
                  type: string
              required:
              - name
              - display_name
              - address
              - city
              - country
              - account_number
      responses:
        '200':
          description: Payment destination creation
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentDestination'
              example:
                id: 88c71f16-2af3-4b06-979d-92b5354a9174
                status: ACTIVE
                default: false
                branch_address: 45 Lansing Street, Dubai, United Arab Emirates
                name: Fulani Al Fulani
                iban: AE760260001015000000601
                display_name: Al Fulani
                address: 1234 Sky Bldg.
                city: Abu Dhabi
                country: ARE
                swift_code: EBILAEADXXX
                account_number: '1015000000601'
                customer_id: d0e8bf5b-0194-4bad-b1cc-df2c3621766a
      deprecated: false
      tags:
      - Payment Destination
      security:
      - bearerAuth: []
    get:
      operationId: getPaymentDestinations
      summary: List Payment Destinations
      description: Retrieve a list of all Payment Destinations you have in stored with Lean.
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PaymentDestination'
              example:
              - id: 6910fddc-417c-f7fd-6e4b-4d7de3d0bc06
                status: ACTIVE
                default: false
                name: Fake Corp.
                iban: AE27LSWP9X25E4883A13998
                display_name: Fake Corp. - AED
                address: 1234 Sky Bldg.
                city: Abu Dhabi
                country: ARE
                swift_code: EBILEADXXX
                account_number: '000120203'
                currency: AED
              - id: 432150ea-99d1-5bd8-aed3-35d4c7a2b4b4
                status: ACTIVE
                default: false
                name: Fake Corp.
                iban: AE27LSWP9X25E4883A139K7
                display_name: Fake Corp. - USD
                address: 1234 Sky Bldg.
                city: Abu Dhabi
                country: ARE
                swift_code: EBILEADXXX
                account_number: '000120202'
                currency: USD
      deprecated: false
      tags:
      - Payment Destination
      security:
      - bearerAuth: []
    servers:
    - url: https://sandbox.leantech.me
      description: Sandbox
    - url: https://api2.leantech.me
      description: Production
  /payments/v1/destinations/{payment_destination_id}:
    get:
      operationId: getPaymentDestinationById
      summary: Get Payment Destination by ID
      description: Retrieve the details of a single Payment Destination stored by Lean.
      parameters:
      - name: payment_destination_id
        in: path
        description: The unique identifier of the Payment Destination.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentDestination'
              example:
                id: 6910fddc-417c-f7fd-6e4b-4d7de3d0bc06
                status: ACTIVE
                default: false
                name: Fake Corp.
                iban: AE27LSWP9X25E4883A13998
                display_name: Fake Corp. - AED
                address: 1234 Sky Bldg.
                city: Abu Dhabi
                country: ARE
                swift_code: EBILEADXXX
                account_number: '000120203'
                currency: AED
      deprecated: false
      tags:
      - Payment Destination
      security:
      - bearerAuth: []
    servers:
    - url: https://sandbox.leantech.me
      description: Sandbox
    - url: https://api2.leantech.me
      description: Production
  /customers/v1/{customer_id}/destinations:
    servers: []
    get:
      operationId: getPaymentDestinationsByCustomerId
      summary: Get Payment Destinations for Customer
      description: Retrieve a list of all Payment Destinations associated with a given Customer.
      parameters:
      - name: customer_id
        in: path
        description: ''
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CustomerPaymentDestination'
                  x-lean-docs-discrepancy: PaymentDestination
              examples:
                '1':
                  summary: Success
                  value:
                  - id: 6910fddc-417c-f7fd-6e4b-4d7de3d0bc06
                    status: CONFIRMED
                    default: false
                    name: Fake Corp.
                    iban: AE27LSWP9X25E4883A13998
                    display_name: Fake Corp. - AED
                    address: 1234 Sky Bldg.
                    city: Abu Dhabi
                    country: ARE
                    swift_code: EBILEADXXX
                    account_number: '000120203'
                    customer_id: 5f76dc1f-a013-4bc0-afad-984c66d50f6d
                  - id: 432150ea-99d1-5bd8-aed3-35d4c7a2b4b4
                    status: CONFIRMED
                    default: false
                    name: Fake Corp.
                    iban: AE27LSWP9X25E4883A139K7
                    display_name: Fake Corp. - USD
                    address: 1234 Sky Bldg.
                    city: Abu Dhabi
                    country: ARE
                    swift_code: EBILEADXXX
                    account_number: '000120202'
                    customer_id: 5f76dc1f-a013-4bc0-afad-984c66d50f6d
      tags:
      - Payment Destination
      security:
      - bearerAuth: []
components:
  schemas:
    PaymentDestination:
      type: object
      properties:
        id:
          description: The unique identifier for the Payment Destination object.
          type: string
          format: uuid
        status:
          description: The status of the Destination
          type: string
          const: ACTIVE
        default:
          description: When `true` this Destination is automatically populated into Payment Intents where an alternative `payment_destination_id` is not provided.
          type: boolean
        branch_address:
          description: The address of the branch that holds the account - required for all beneficiaries outside of ARE. This should be a single string with commas separating lines.
          type: string
        name:
          description: The name of the legal entity that owns the account.
          type: string
        iban:
          description: 'The IBAN of the account.

            This is required for all countries except for the US.'
          type: string
        display_name:
          description: The friendly display name for the account. This is rendered in the LinkSDK when referencing the Destination.
          type: string
        address:
          description: The address of the owner of the destination bank account has registered with the bank.
          type: string
        city:
          description: The city that the holding financial institution is located in.
          type: string
        country:
          description: The three letter ISO code for the holding financial institution's country.
          type: string
        swift_code:
          description: The SWIFT Code for the bank account - required for most international destinations
          type: string
        account_number:
          description: The account number for the account.
          type: string
        customer_id:
          description: The Customer object associated with this account. This field is optional, and will designate the Destination as owned by the application if not provided.
          type: string
        ifsc:
          description: The IFSC number for the bank account - required for international destinations in India.
          type: string
        transit_number:
          description: The Transit Number for the bank account - required for international destinations in Canada
          type: string
        sort_code:
          description: The Sort Code for the bank account - required for international destinations in the UK
          type: string
        routing_number:
          description: The Routing Number for the bank account - required for international destinations in the US.
          type: string
        postal_code:
          description: The Postal Code of the owner of the destination bank account has registered with the bank - required for international destinations in the UK or the US
          type: string
        currency:
          description: The currency of the destination bank account - required for international destinations in the UK or the US
          type: string
      required:
      - id
      - status
      - default
      - name
      - display_name
      - address
      - city
      - country
      - account_number
    CustomerPaymentDestination:
      type: object
      properties:
        id:
          description: The unique identifier for the Payment Destination object.
          type: string
          format: uuid
        customer_id:
          description: The Customer object associated with this account. This field is optional, and will designate the Destination as owned by the application if not provided.
          type: string
        bank_identifier:
          description: The Lean identifier for the destination bank
          type: string
        status:
          description: The status of the Destination
          type: string
          enum:
          - CONFIRMED
          - PENDING
        default:
          description: When `true` this Destination is automatically populated into Payment Intents where an alternative `payment_destination_id` is not provided.
          type: boolean
        name:
          description: The name of the legal entity that owns the account.
          type: string
        iban:
          description: 'The IBAN of the account.

            This is required for all countries except for the US.'
          type: string
        display_name:
          description: The friendly display name for the account. This is rendered in the LinkSDK when referencing the Destination.
          type: string
        address:
          description: The address of the owner of the destination bank account has registered with the bank.
          type: string
        city:
          description: The city that the holding financial institution is located in.
          type: string
        country:
          description: The three letter ISO code for the holding financial institution's country.
          type: string
        swift_code:
          description: The SWIFT Code for the bank account - required for most international destinations
          type: string
        account_number:
          description: The account number for the account.
          type: string
      required:
      - id
      - customer_id
      - status
      - default
      - name
      - display_name
      - address
      - city
      - country
      - account_number
    PaymentDestination_2:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier for the Payment Destination object.
        status:
          type: string
          enum:
          - CONFIRMED
          - PENDING
          description: The status of the Destination
        default:
          type: string
          description: When `true` this Destination is automatically populated into Payment Intents where an alternative `payment_destination_id` is not provided.
        branch_address:
          type: string
          description: The address of the branch that holds the account - required for all beneficiaries outside of ARE. This should be a single string with commas separating lines.
        name:
          type: string
          description: The name of the legal entity that owns the account.
        iban:
          type: string
          description: 'The IBAN of the account.

            This is required for all countries except for the US.'
        display_name:
          type: string
          description: The friendly display name for the account. This is rendered in the LinkSDK when referencing the Destination.
        address:
          type: string
          description: The address of the owner of the destination bank account has registered with the bank.
        city:
          type: string
          description: The city that the holding financial institution is located in.
        country:
          type: string
          description: The three letter ISO code for the holding financial institution's country.
        swift_code:
          type: string
          description: The SWIFT Code for the bank account - required for most international destinations
        account_number:
          type: string
          description: The account number for the account.
        customer_id:
          type: string
          description: The Customer object associated with this account. This field is optional, and will designate the Destination as owned by the application if not provided.
        ifsc:
          type: string
          description: The IFSC number for the bank account - required for international destinations in India.
        transit_number:
          type: string
          description: The Transit Number for the bank account - required for international destinations in Canada
        sort_code:
          type: string
          description: The Sort Code for the bank account - required for international destinations in the UK
        routing_number:
          type: string
          description: The Routing Number for the bank account - required for international destinations in the US.
        postal_code:
          type: string
          description: The Postal Code of the owner of the destination bank account has registered with the bank - required for international destinations in the UK or the US
        currency:
          type: string
          description: The currency of the destination bank account - required for international destinations in the UK or the US
      required:
      - id
      - status
      - default
      - name
      - display_name
      - address
      - city
      - country
      - account_number
    GovernmentIdentifierRequest:
      type: object
      required:
      - type
      - value
      properties:
        value:
          type: string
          description: The identifier value
          minLength: 1
          pattern: ^(?!\s*$).+
        type:
          type: string
          description: The type of Government ID
          enum:
          - EMIRATES_ID
          - TRADE_LICENSE_NUMBER
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    bearer:
      type: http
      scheme: bearer
x-refined-from:
- lean-technologies-payments-core-openapi.yml
- lean-technologies-payments-customers-openapi.yml
- lean-technologies-payments-openapi.yml