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/lianlian-global-beneficiaries-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Payouts Beneficiaries API
  version: '1.0'
  description: payout能力
servers:
- url: https://global-api.lianlian.com/api/v1
tags:
- name: Beneficiaries
paths:
  /beneficiaries/{beneficiary_id}:
    parameters:
    - schema:
        type: string
      name: beneficiary_id
      in: path
      required: true
    get:
      summary: Get a beneficiary by ID
      tags:
      - Beneficiaries
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: ../models/BeneficiaryResponse.yaml
        '400':
          description: '**code**|**message**

            ---|---

            PARAM_ERROR|A parameter value is not valid or missing.'
          content:
            application/json:
              schema:
                $ref: ../models/Error.yaml
      operationId: ''
      description: 根据收款人唯一ID获取收款人详情信息。
      security:
      - 客户端凭据授权: []
      parameters:
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Content-Type
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Authorization
    delete:
      summary: Delete a beneficiary
      operationId: delede_beneficiary
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: boolean
                    x-stoplight:
                      id: rxwmctu9xnhf8
                    description: 删除结果
                  beneficiary_id:
                    type: string
                    x-stoplight:
                      id: 9ehe79x3fhzcy
                    description: '收款人ID


                      '
                    maxLength: 64
                required:
                - result
                - beneficiary_id
        '400':
          description: '**code**|**message**

            ---|---

            PARAM_ERROR|A parameter value is not valid or missing.

            BENEFICIARY_NOT_EXISTS|beneficiary not exists'
          content:
            application/json:
              schema:
                $ref: ../models/Error.yaml
      tags:
      - Beneficiaries
      description: '删除已经存在的收款人。

        - 业务字段（beneficiary_id）相同时，不支持幂等'
      security:
      - 客户端凭据授权: []
      parameters:
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Content-Type
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Authorization
    post:
      summary: Update a beneficiary
      operationId: update_beneficiary
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: ../models/BeneficiaryUpdateResponse.yaml
        '400':
          description: '**code**|**message**

            ---|---

            PARAM_ERROR|A parameter value is not valid or missing.

            BENEFICIARY_ATTACHMENTS_EXCEEDS_LIMIT|beneficiary attachments exceeds limit

            CHARACTER_INVALID|character_invalid

            STATUS_NOT_SUPPORT|status not support

            BENEFICIARY_NOT_EXISTS|beneficiary not exists'
          content:
            application/json:
              schema:
                $ref: ../models/Error.yaml
      requestBody:
        content:
          application/json:
            schema:
              $ref: ../models/BeneficiaryUpdateRequest.yaml
      tags:
      - Beneficiaries
      description: '仅允许状态为失败的收款人，进行信息更新。

        - 当status为FAILED时，允许提交，提交后状态变为PROCESSING。该接口不允许同一beneficiary_id并发提交，会返回REQUEST_CONFLICT

        提供了根据beneficiary_id查询的接口获取最新状态'
      security:
      - 客户端凭据授权: []
      parameters:
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Content-Type
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Authorization
  /beneficiaries:
    parameters: []
    get:
      summary: Get list of beneficiaries
      operationId: listof_beneficiary
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  page_size:
                    type: string
                    x-stoplight:
                      id: oh4goruzkhskh
                    description: 每页条数
                  page:
                    type: string
                    x-stoplight:
                      id: 2i5dlqz3akmpu
                    description: 当前页码
                  total_count:
                    type: string
                    description: 总条数
                  total_page:
                    type: string
                    x-stoplight:
                      id: v9t08qudb8bdr
                    description: 总页数
                  page_list:
                    type: array
                    x-stoplight:
                      id: f7qky73siifc6
                    items:
                      $ref: ../models/BeneficiaryListResponse.yaml
                      x-stoplight:
                        id: 8suuyerj6uw9l
        '400':
          description: '**code**|**message**

            ---|---

            PARAM_ERROR|A parameter value is not valid or missing.'
          content:
            application/json:
              schema:
                $ref: ../models/Error.yaml
      requestBody:
        content: {}
        description: ''
      description: 获取收款人列表信息。
      tags:
      - Beneficiaries
      security:
      - 客户端凭据授权: []
      parameters:
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Content-Type
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Authorization
      - schema:
          type: string
        in: query
        name: account_currency
        description: 收款银行账户币种
      - schema:
          type: string
        in: query
        name: purpose
        description: 交易类型
      - schema:
          type: string
        in: query
        name: status
        description: 收款人状态
      - schema:
          type: number
        in: query
        name: start_time
        description: 开始时间，13位时间戳毫秒
      - schema:
          type: string
        in: query
        description: 结束时间，13位时间戳毫秒
        name: end_time
      - schema:
          type: string
        in: query
        name: page
        description: 页码，默认值为1
      - schema:
          type: string
        in: query
        name: page_size
        description: 每页查询数量，默认值为20
      - schema:
          type: string
        in: query
        name: beneficiary_account_type
        description: 收款账户类型，BANK_ACCOUNT 分发到银行账户、LL_ACCOUNT 分发到连连内部户
      - schema:
          type: string
        in: query
        name: request_id
        description: 客户端请求ID
      x-stoplight:
        id: req12lu5iqhc7
    post:
      summary: Create a beneficiary
      operationId: create_beneficiary
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: ../models/BeneficiaryCreateResponse.yaml
              examples: {}
        '400':
          description: '**code**|**message**

            ---|---

            PARAM_ERROR|A parameter value is not valid or missing.

            BENEFICIARY_ATTACHMENTS_EXCEEDS_LIMIT|beneficiary attachments exceeds limit

            CHARACTER_INVALID|character_invalid

            USER_NOT_EXIST|user not exist

            USER_KYC_FAILED|user kyc failed

            REQUEST_ID_NOT_UNIQUE|request id not unique

            WITHDRAW_ACCOUNT_INVALID|withdraw account invalid

            BENEFICIARY_ALREADY_EXISTS|beneficiary already exists'
          content:
            application/json:
              schema:
                $ref: ../models/Error.yaml
      requestBody:
        content:
          application/json:
            schema:
              $ref: ../models/BeneficiaryRequest .yaml
            examples: {}
        description: ''
      description: '创建一个收款人。

        - request_id相同，业务字段相同时，幂等返回

        - request_id相同，业务字段不同时，会返回REQUEST_ID_IS_NOT_UNIQUE

        - request_id不同，业务字段相同时，会返回BENEFICIARY_ALREADY_EXISTS

        对于接口超时情况，可使用原报文重试或使用request_id调用Get list of beneficiaries收款人列表查询接口。'
      tags:
      - Beneficiaries
      security:
      - 客户端凭据授权: []
      parameters:
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Content-Type
      - $ref: ../Base/Webhooks.yaml#/components/parameters/header-Authorization
components:
  securitySchemes:
    Component:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /oauth2/token
          refreshUrl: /oauth2/token
          scopes: {}
      description: 详情参考[Authentication](https://developer.lianlianglobal.com/docs/lppe/b6b6c2d4906e9-authentication) > 客户端凭据授权
    Component_2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: ''
          tokenUrl: ''
          refreshUrl: ''
          scopes: {}
      description: 详情参考[Authentication](https://developer.lianlianglobal.com/docs/lppe/b6b6c2d4906e9-authentication) > 授权码授权
x-stoplight:
  id: w073d3fxcx3df