> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get delivery options

> Returns the delivery methods, estimated times, and prices for sending a physical card to an address.



## OpenAPI

````yaml /specs/company.openapi.yaml post /developer/cards/delivery-options
openapi: 3.1.0
info:
  title: Incard Developer API
  version: 0.1.0
  description: OpenAPI definition for the Incard Developer API.
servers:
  - url: https://api.incard.com
    description: Developer Gateway
security:
  - BearerAuth: []
tags:
  - name: ACCOUNTS
    description: Currency accounts and their available balances.
  - name: TRANSACTIONS
    description: Transaction history with filters, pagination, and running balances.
  - name: CARDS
    description: Issue, list, freeze, replace, and set spending limits on cards.
  - name: INVOICES
  - name: webhooks
paths:
  /developer/cards/delivery-options:
    post:
      tags:
        - CARDS
      summary: Get delivery options
      description: >-
        Returns the delivery methods, estimated times, and prices for sending a
        physical card to an address.
      operationId: get_card_delivery_options
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - delivery_address
              properties:
                delivery_address:
                  $ref: '#/components/schemas/DeliveryAddress'
            example:
              delivery_address:
                line1: 1 Example Street
                city: London
                post_code: EC1A 1BB
                country_code: GB
      responses:
        '200':
          description: Delivery methods available for the address.
          content:
            application/json:
              schema:
                type: object
                properties:
                  delivery_methods:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeliveryOption'
              example:
                delivery_methods:
                  - method: classic
                    eta:
                      max_business_days: 5
                    price:
                      amount: '0.00'
                      currency: GBP
                  - method: express
                    eta:
                      max_business_days: 3
                    price:
                      amount: '9.99'
                      currency: GBP
        '400':
          $ref: '#/components/responses/CardBadRequest'
        '401':
          description: Unauthorized
        '422':
          description: Cards cannot be delivered to this country.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CardError'
              example:
                error: cards cannot be delivered to this country
components:
  schemas:
    DeliveryAddress:
      type: object
      title: DeliveryAddress
      description: Required fields and formats depend on the country.
      properties:
        line1:
          type: string
          maxLength: 100
        line2:
          type: string
          maxLength: 100
        line3:
          type: string
          maxLength: 50
        city:
          type: string
          maxLength: 50
        state:
          type: string
          maxLength: 50
        post_code:
          type: string
          maxLength: 10
        country_code:
          type: string
          description: ISO 3166-1 alpha-2 country code.
      required:
        - line1
        - country_code
    DeliveryOption:
      type: object
      title: DeliveryOption
      properties:
        method:
          type: string
          enum:
            - classic
            - express
            - international
        eta:
          type: object
          properties:
            min_business_days:
              type: integer
              description: Omitted when 0.
            max_business_days:
              type: integer
        price:
          type: object
          properties:
            amount:
              type: string
            currency:
              type: string
    CardError:
      type: object
      title: CardError
      properties:
        error:
          type: string
      required:
        - error
  responses:
    CardBadRequest:
      description: Invalid request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CardError'
          example:
            error: 'invalid spending limit: amount has more than 2 decimal places'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: access_token
      description: Short-lived access token. Obtain with your api_key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.