openapi: 3.2.0
info:
  title: Cards Card restrictions API
  version: '1'
  description: Cards API
servers:
- url: https://sandbox.bond.tech/api/v0.1
security:
- identity: []
  authorization: []
tags:
- name: Card restrictions
paths:
  /cards/{card_id}/restrictions:
    parameters:
    - schema:
        type: string
      name: card_id
      in: path
      required: true
    get:
      summary: Retrieve card restrictions
      operationId: get_cards_restrictions
      description: Retrieve all restrictions on a card
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                description: ''
                type: object
                x-examples:
                  example-1:
                    card: 8d8b0aa0-5eec-4eab-923d-2bd777c9a07d
                    restrictions:
                    - uuid: 5fb767a2-f3f7-4a9b-9f5f-63bf87a8553a
                      card_id: 8d8b0aa0-5eec-4eab-923d-2bd777c9a07d
                      restriction_type: amount
                      max_amount: '100.00'
                      date_created: '2020-05-29T14:59:38.386850'
                      date_updated: '2020-06-29T14:59:38.386930'
                properties:
                  card:
                    type: string
                    minLength: 1
                  restrictions:
                    type: array
                    uniqueItems: true
                    minItems: 1
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                          minLength: 1
                          format: uuid
                          example: 846b9f2a-0e34-4783-ac74-83bb89781a05
                        card_id:
                          type: string
                          minLength: 1
                          format: uuid
                          example: a593e8c1-bcd3-4747-a903-2a829fa4e3fe
                        restriction_type:
                          type: string
                          minLength: 1
                          example: amount
                          enum:
                          - amount
                        max_amount:
                          type: string
                          minLength: 1
                          example: '100.00'
                        date_created:
                          type: string
                          minLength: 1
                          example: '2020-06-29T14:59:38.386930'
                        date_updated:
                          type: string
                          minLength: 1
                          example: '2020-06-29T14:59:38.386930'
                      required:
                      - uuid
                      - card_id
                      - restriction_type
                      - max_amount
                      - date_created
                      - date_updated
                required:
                - card
                - restrictions
      tags:
      - Card restrictions
    post:
      summary: Create card restriction
      operationId: post_cards_restrictions
      description: Create card restriction for a card
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/card-restriction-write'
            examples:
              example:
                value:
                  restriction_type: amount
                  max_amount: '100.00'
      tags:
      - Card restrictions
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/card-restriction'
              examples:
                example:
                  value:
                    uuid: b7492825-adce-4164-b8ba-5676943b6237
                    card_id: dab45fde-3450-4fbf-b671-9605756c1c8c
                    restriction_type: amount
                    max_amount: string
                    date_created: '2020-06-29T14:59:38.386930'
                    date_updated: '2020-06-30T14:59:38.386930'
  /cards/{card_id}/restrictions/{restriction_id}:
    parameters:
    - schema:
        type: string
      name: card_id
      in: path
      required: true
    - schema:
        type: string
      name: restriction_id
      in: path
      required: true
    get:
      summary: Retrieve card restriction by id
      operationId: get_cards_restrictions_id
      description: Updatess restriction on a card.
      tags:
      - Card restrictions
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/card-restriction'
    patch:
      summary: Update card restriction
      operationId: patch_cards_restrictions
      description: Updates restriction on a card.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/card-restriction-write'
            examples:
              example:
                value:
                  restriction_type: amount
                  max_amount: '100.00'
        description: ''
      tags:
      - Card restrictions
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/card-restriction'
              examples:
                example:
                  value:
                    uuid: b7492825-adce-4164-b8ba-5676943b6237
                    card_id: dab45fde-3450-4fbf-b671-9605756c1c8c
                    restriction_type: amount
                    max_amount: string
                    date_created: '2020-06-29T14:59:38.386930'
                    date_updated: '2020-06-30T14:59:38.386930'
    delete:
      summary: Delete card restriction
      operationId: delete_cards_restrictions
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: Card Restriction Removed
                    readOnly: true
              examples:
                example:
                  value:
                    Status: Card Restriction Removed
      description: Delete the selected restriction on a card
      tags:
      - Card restrictions
components:
  schemas:
    card-restriction:
      title: card-restriction
      description: Example response
      type: object
      properties:
        uuid:
          type: string
          minLength: 1
          format: uuid
          example: b7492825-adce-4164-b8ba-5676943b6237
        card_id:
          type: string
          minLength: 1
          format: uuid
          example: dab45fde-3450-4fbf-b671-9605756c1c8c
        restriction_type:
          type: string
          minLength: 1
          enum:
          - amount
          example: amount
        max_amount:
          type: string
          minLength: 1
        date_created:
          type: string
          minLength: 1
          example: '2020-06-29T14:59:38.386930'
        date_updated:
          type: string
          minLength: 1
          example: '2020-06-30T14:59:38.386930'
      required:
      - uuid
      - card_id
      - restriction_type
      - max_amount
      - date_created
      - date_updated
      x-examples:
        example:
          uuid: b7492825-adce-4164-b8ba-5676943b6237
          card_id: dab45fde-3450-4fbf-b671-9605756c1c8c
          restriction_type: amount
          max_amount: string
          date_created: '2020-06-29T14:59:38.386930'
          date_updated: '2020-06-30T14:59:38.386930'
    card-restriction-write:
      description: ''
      type: object
      x-examples:
        example-1:
          uuid: da4ab5b1-77d4-4c25-b791-1f01ff7bce27
          card_id: 8d8b0aa0-5eec-4eab-923d-2bd777c9a07d
          restriction_type: amount
          max_amount: '100.00'
          date_created: '2020-05-29T14:59:38.386850'
          date_updated: '2020-06-29T14:59:38.386930'
      title: card-restriction-write
      properties:
        restriction_type:
          type: string
          minLength: 1
          description: The type of restriction
          enum:
          - amount
          example: amount
        max_amount:
          type: string
          minLength: 1
          description: 'purchase amount limit

            `(decimal format, allows for two decimal places. Maximum amount is 100,000)`'
          example: '100.00'
      required:
      - restriction_type
      - max_amount
  securitySchemes:
    identity:
      type: apiKey
      in: header
      name: Identity
    authorization:
      type: apiKey
      in: header
      name: Authorization
x-samples-languages:
- curl
- node
- ruby
- javascript
- python
- csharp
- java
x-provenance:
  method: searched
  source: https://docs.bond.tech/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.bond.tech/reference/delete_cards_restrictions.md
  - https://docs.bond.tech/reference/get_cards.md
  - https://docs.bond.tech/reference/get_cards_id.md
  - https://docs.bond.tech/reference/get_cards_restrictions.md
  - https://docs.bond.tech/reference/get_cards_restrictions_id.md
  - https://docs.bond.tech/reference/patch_cards.md
  - https://docs.bond.tech/reference/patch_cards_restrictions.md
  - https://docs.bond.tech/reference/post_cards.md
  - https://docs.bond.tech/reference/post_cards_activate.md
  - https://docs.bond.tech/reference/post_cards_close.md
  - https://docs.bond.tech/reference/post_cards_reissue.md
  - https://docs.bond.tech/reference/post_cards_restrictions.md
  merge:
    pages: 12
    deduped: 36
    conflicts_kept_first: 0