Increase Lockbox Recipients API

Lockbox Recipients represent an inbox at a Lockbox Address. Checks received for a Lockbox Recipient are deposited into its associated Account.

Operations 4

GET /lockbox_recipients List Lockbox Recipients #
POST /lockbox_recipients Create a Lockbox Recipient #
GET /lockbox_recipients/{lockbox_recipient_id} Retrieve a Lockbox Recipient #
PATCH /lockbox_recipients/{lockbox_recipient_id} Update a Lockbox Recipient #

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/increase-lockbox-recipients-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

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

OpenAPI Specification

increase-lockbox-recipients-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: Anything that you can achieve with PDFs, presence, and persistence in a bank branch you can do with our API.
  title: Increase Lockbox Recipients API
  version: 0.0.1
servers:
- url: https://api.increase.com
- url: https://sandbox.increase.com
security:
- bearerAuth: []
tags:
- description: Lockbox Recipients represent an inbox at a Lockbox Address. Checks received for a Lockbox Recipient are deposited into its associated Account.
  name: Lockbox Recipients
paths:
  /lockbox_recipients:
    get:
      operationId: list_lockbox_recipients
      parameters:
      - in: query
        name: cursor
        required: false
        schema:
          description: Return the page of entries after this one.
          type: string
          x-documentation-priority: low
      - in: query
        name: limit
        required: false
        schema:
          description: Limit the size of the list that is returned. The default (and maximum) is 100 objects.
          minimum: 1
          type: integer
          x-documentation-priority: low
      - in: query
        name: account_id
        required: false
        schema:
          description: Filter Lockbox Recipients to those associated with the provided Account.
          type: string
          x-documentation-priority: default
          x-id-reference-to: Accounts
      - in: query
        name: lockbox_address_id
        required: false
        schema:
          description: Filter Lockbox Recipients to those associated with the provided Lockbox Address.
          type: string
          x-documentation-priority: default
          x-id-reference-to: Lockbox Addresses
      - in: query
        name: created_at.after
        required: false
        schema:
          description: Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
          format: date-time
          type: string
          x-documentation-priority: low
      - in: query
        name: created_at.before
        required: false
        schema:
          description: Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
          format: date-time
          type: string
          x-documentation-priority: low
      - in: query
        name: created_at.on_or_after
        required: false
        schema:
          description: Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
          format: date-time
          type: string
          x-documentation-priority: low
      - in: query
        name: created_at.on_or_before
        required: false
        schema:
          description: Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
          format: date-time
          type: string
          x-documentation-priority: low
      - in: query
        name: idempotency_key
        required: false
        schema:
          description: Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
          maxLength: 200
          minLength: 1
          type: string
          x-documentation-priority: default
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/lockbox_recipient_list'
          description: Lockbox Recipient List
        4XX:
          $ref: '#/components/responses/errorResponse'
        5XX:
          $ref: '#/components/responses/errorResponse'
      summary: List Lockbox Recipients
      x-sandbox-only: false
      x-tag: Lockbox Recipients
      tags:
      - Lockbox Recipients
    post:
      operationId: create_a_lockbox_recipient
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/create_a_lockbox_recipient_parameters'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/lockbox_recipient'
          description: Lockbox Recipient
        4XX:
          $ref: '#/components/responses/errorResponse'
        5XX:
          $ref: '#/components/responses/errorResponse'
      summary: Create a Lockbox Recipient
      x-sandbox-only: false
      x-tag: Lockbox Recipients
      tags:
      - Lockbox Recipients
  /lockbox_recipients/{lockbox_recipient_id}:
    get:
      operationId: retrieve_a_lockbox_recipient
      parameters:
      - example: lockbox_3xt21ok13q19advds4t5
        in: path
        name: lockbox_recipient_id
        required: true
        schema:
          description: The identifier of the Lockbox Recipient to retrieve.
          type: string
          x-documentation-priority: default
          x-id-reference-to: Lockbox Recipients
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/lockbox_recipient'
          description: Lockbox Recipient
        4XX:
          $ref: '#/components/responses/errorResponse'
        5XX:
          $ref: '#/components/responses/errorResponse'
      summary: Retrieve a Lockbox Recipient
      x-sandbox-only: false
      x-tag: Lockbox Recipients
      tags:
      - Lockbox Recipients
    patch:
      operationId: update_a_lockbox_recipient
      parameters:
      - example: lockbox_3xt21ok13q19advds4t5
        in: path
        name: lockbox_recipient_id
        required: true
        schema:
          description: The identifier of the Lockbox Recipient.
          type: string
          x-documentation-priority: default
          x-id-reference-to: Lockbox Recipients
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/update_a_lockbox_recipient_parameters'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/lockbox_recipient'
          description: Lockbox Recipient
        4XX:
          $ref: '#/components/responses/errorResponse'
        5XX:
          $ref: '#/components/responses/errorResponse'
      summary: Update a Lockbox Recipient
      x-sandbox-only: false
      x-tag: Lockbox Recipients
      tags:
      - Lockbox Recipients
components:
  schemas:
    create_a_lockbox_recipient_parameters:
      additionalProperties: true
      example:
        account_id: account_in71c4amph0vgo2qllky
        lockbox_address_id: lockbox_address_lw6sbzl9ol5dfd8hdml6
        recipient_name: Ian Crease
      properties:
        account_id:
          description: The Account that checks sent to this Lockbox Recipient should be deposited into.
          type: string
          x-documentation-priority: default
          x-id-reference-to: Accounts
        description:
          description: The description you choose for the Lockbox Recipient.
          maxLength: 200
          minLength: 1
          type: string
          x-documentation-priority: default
        lockbox_address_id:
          description: The Lockbox Address where this Lockbox Recipient may receive mail.
          type: string
          x-documentation-priority: default
          x-id-reference-to: Lockbox Addresses
        recipient_name:
          description: The name of the Lockbox Recipient
          maxLength: 200
          minLength: 1
          type: string
          x-documentation-priority: default
      required:
      - account_id
      - lockbox_address_id
      type: object
      x-event-categories: []
      x-stainless-empty-object: false
    update_a_lockbox_recipient_parameters:
      additionalProperties: false
      example:
        status: active
      properties:
        description:
          description: The description you choose for the Lockbox Recipient.
          maxLength: 200
          minLength: 1
          type: string
          x-documentation-priority: default
        recipient_name:
          description: The name of the Lockbox Recipient.
          maxLength: 200
          minLength: 1
          type: string
          x-documentation-priority: default
        status:
          description: The status of the Lockbox Recipient.
          enum:
          - active
          - disabled
          - canceled
          type: string
          x-documentation-priority: default
          x-enum-descriptions:
          - This Lockbox Recipient is active.
          - This Lockbox Recipient is disabled. Checks mailed to this Lockbox Recipient will be rejected.
          - This Lockbox Recipient is canceled and cannot be modified. Checks mailed to this Lockbox Recipient will be rejected.
      type: object
      x-event-categories: []
      x-stainless-empty-object: false
    lockbox_recipient:
      additionalProperties: false
      description: Lockbox Recipients represent an inbox at a Lockbox Address. Checks received for a Lockbox Recipient are deposited into its associated Account.
      example:
        account_id: account_in71c4amph0vgo2qllky
        created_at: '2020-01-31T23:59:59Z'
        description: null
        id: lockbox_3xt21ok13q19advds4t5
        idempotency_key: null
        lockbox_address_id: lockbox_address_lw6sbzl9ol5dfd8hdml6
        mail_stop_code: VRE6P
        recipient_name: Company Inc.
        status: active
        type: lockbox_recipient
      properties:
        account_id:
          description: The identifier for the Account that checks sent to this Lockbox Recipient will be deposited into.
          type: string
          x-documentation-priority: default
          x-id-reference-to: Accounts
        created_at:
          description: The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Lockbox Recipient was created.
          format: date-time
          type: string
          x-documentation-priority: default
        description:
          anyOf:
          - description: The description of the Lockbox Recipient.
            type: string
            x-documentation-priority: default
          - type: 'null'
        id:
          description: The Lockbox Recipient identifier.
          type: string
          x-documentation-priority: default
          x-id-reference-to: Lockbox Recipients
        idempotency_key:
          anyOf:
          - description: The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
            type: string
            x-documentation-priority: default
          - type: 'null'
        lockbox_address_id:
          description: The identifier for the Lockbox Address where this Lockbox Recipient may receive physical mail.
          type: string
          x-documentation-priority: default
          x-id-reference-to: Lockbox Addresses
        mail_stop_code:
          description: The mail stop code uniquely identifying this Lockbox Recipient at its Lockbox Address. It should be included in the mailing address intended for this Lockbox Recipient.
          type: string
          x-documentation-priority: default
        recipient_name:
          anyOf:
          - description: The name of the Lockbox Recipient.
            type: string
            x-documentation-priority: default
          - type: 'null'
        status:
          anyOf:
          - description: The status of the Lockbox Recipient.
            enum:
            - active
            - disabled
            - canceled
            type: string
            x-documentation-priority: default
            x-enum-descriptions:
            - This Lockbox Recipient is active.
            - This Lockbox Recipient is disabled. Checks mailed to this Lockbox Recipient will be rejected.
            - This Lockbox Recipient is canceled and cannot be modified. Checks mailed to this Lockbox Recipient will be rejected.
          - type: 'null'
        type:
          description: A constant representing the object's type. For this resource it will always be `lockbox_recipient`.
          enum:
          - lockbox_recipient
          type: string
          x-documentation-priority: default
      required:
      - type
      - account_id
      - id
      - created_at
      - recipient_name
      - description
      - mail_stop_code
      - lockbox_address_id
      - status
      - idempotency_key
      title: Lockbox Recipient
      type: object
      x-event-categories:
      - lockbox.created
      - lockbox.updated
      x-stainless-empty-object: false
      x-tag: Lockbox Recipients
      x-title-plural: Lockbox Recipients
    error:
      anyOf:
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          status:
            enum:
            - 404
            type: integer
          title:
            type: string
          type:
            enum:
            - api_method_not_found_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          status:
            enum:
            - 403
            type: integer
          title:
            type: string
          type:
            enum:
            - environment_mismatch_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          resource_id:
            description: ''
            type: string
            x-documentation-priority: default
          status:
            enum:
            - 409
            type: integer
          title:
            type: string
          type:
            enum:
            - idempotency_key_already_used_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        - resource_id
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          status:
            enum:
            - 403
            type: integer
          title:
            type: string
          type:
            enum:
            - insufficient_permissions_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          status:
            enum:
            - 500
            type: integer
          title:
            type: string
          type:
            enum:
            - internal_server_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          reason:
            description: ''
            enum:
            - deleted_credential
            - expired_credential
            - ip_not_allowed
            - no_credential
            - no_header
            - no_api_access
            - wrong_environment
            type: string
            x-documentation-priority: default
            x-enum-descriptions:
            - deleted_credential
            - expired_credential
            - ip_not_allowed
            - no_credential
            - no_header
            - no_api_access
            - wrong_environment
          status:
            enum:
            - 401
            type: integer
          title:
            type: string
          type:
            enum:
            - invalid_api_key_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        - reason
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          status:
            enum:
            - 409
            type: integer
          title:
            type: string
          type:
            enum:
            - invalid_operation_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          errors:
            description: All errors related to parsing the request parameters.
            items:
              additionalProperties: true
              properties: {}
              title: ErrorsElement
              type: object
              x-event-categories: []
              x-stainless-empty-object: false
              x-title-plural: ErrorsElements
            type: array
            x-documentation-priority: default
          status:
            enum:
            - 400
            type: integer
          title:
            type: string
          type:
            enum:
            - invalid_parameters_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        - errors
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          status:
            enum:
            - 400
            type: integer
          title:
            type: string
          type:
            enum:
            - malformed_request_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          status:
            enum:
            - 404
            type: integer
          title:
            type: string
          type:
            enum:
            - object_not_found_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          status:
            enum:
            - 403
            type: integer
          title:
            type: string
          type:
            enum:
            - private_feature_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        type: object
        x-event-categories: []
      - properties:
          detail:
            anyOf:
            - type: string
            - type: 'null'
          retry_after:
            anyOf:
            - description: ''
              type: integer
              x-documentation-priority: default
            - type: 'null'
          status:
            enum:
            - 429
            type: integer
          title:
            type: string
          type:
            enum:
            - rate_limited_error
            type: string
        required:
        - type
        - title
        - detail
        - status
        type: object
        x-event-categories: []
    lockbox_recipient_list:
      additionalProperties: true
      description: A list of Lockbox Recipient objects.
      example:
        data:
        - account_id: account_in71c4amph0vgo2qllky
          created_at: '2020-01-31T23:59:59Z'
          description: null
          id: lockbox_3xt21ok13q19advds4t5
          idempotency_key: null
          lockbox_address_id: lockbox_address_lw6sbzl9ol5dfd8hdml6
          mail_stop_code: VRE6P
          recipient_name: Company Inc.
          status: active
          type: lockbox_recipient
        next_cursor: v57w5d
      properties:
        data:
          description: The contents of the list.
          items:
            $ref: '#/components/schemas/lockbox_recipient'
          type: array
          x-documentation-priority: default
        next_cursor:
          anyOf:
          - description: A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.
            type: string
            x-documentation-priority: default
          - type: 'null'
      required:
      - data
      - next_cursor
      title: Lockbox Recipient List
      type: object
      x-event-categories: []
      x-stainless-empty-object: false
      x-title-plural: Lockbox Recipient Lists
  responses:
    errorResponse:
      content:
        application/json:
          schema:
            allOf:
            - $ref: '#/components/schemas/error'
      description: Error
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
x-tagGroups:
- name: Accounts
  tags:
  - Accounts
  - Account Numbers
  - Account Transfers
- name: Transactions
  tags:
  - Transactions
  - Pending Transactions
  - Declined Transactions
- name: Ach Transfers
  tags:
  - ACH Transfers
  - Inbound ACH Transfers
  - ACH Prenotifications
- name: Check Transfers
  tags:
  - Check Transfers
  - Inbound Check Deposits
- name: Real Time Payments Transfers
  tags:
  - Real-Time Payments Transfers
  - Inbound Real-Time Payments Transfers
- name: Fednow Transfers
  tags:
  - FedNow Transfers
  - Inbound FedNow Transfers
- name: Swift Transfers
  tags:
  - Swift Transfers
- name: Wire Transfers
  tags:
  - Wire Transfers
  - Inbound Wire Transfers
  - Wire Drawdown Requests
  - Inbound Wire Drawdown Requests
- name: Card Transfers
  tags:
  - Card Tokens
  - Card Push Transfers
  - Card Validations
- name: Check Deposits
  tags:
  - Check Deposits
  - Lockbox Addresses
  - Lockbox Recipients
  - Inbound Mail Items
- name: Cards
  tags:
  - Cards
  - Card Payments
  - Card Purchase Supplements
  - Card Disputes
  - Physical Cards
  - Digital Card Profiles
  - Physical Card Profiles
  - Digital Wallet Tokens
- name: Compliance
  tags:
  - Entities
  - Beneficial Owners
  - Supplemental Documents
  - Entity Onboarding Sessions
  - Programs
- name: Events and Webhooks
  tags:
  - Events
  - Event Subscriptions
  - Real-Time Decisions
- name: External Accounts
  tags:
  - Routing Numbers
  - External Accounts
- name: Files and Exports
  tags:
  - Account Statements
  - Files
  - File Links
  - Exports
- name: OAuth
  tags:
  - Groups
  - OAuth Applications
  - OAuth Connections
  - OAuth Tokens
- name: Intrafi
  tags:
  - IntraFi Account Enrollments
  - IntraFi Balances
  - IntraFi Exclusions