Check Self-Ship Collection Availability

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://api-reference.arta.io/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Arta API Reference MCP server": {
    "url": "https://api-reference.arta.io/mcp"
  }
}
Close
POST /self_ship_collection_availability_checks

Availability: Public Preview

This endpoint is currently in public preview and available only to approved accounts. Please contact Arta to request access for your organization.

Check carrier pickup availability for a given location, service, and date.

For DHL, self-ship collections are supported in the US and UK. DHL pickups can be scheduled up to 10 days in advance, on business days only (Monday–Friday in the US, Monday–Saturday in the UK); the returned availabilities reflect these rules.

Headers

  • Authorization string Required

    Authorize your API calls with an Arta API token

application/json

Body

  • self_ship_collection_availability_check object Required
    Hide self_ship_collection_availability_check attributes Show self_ship_collection_availability_check attributes object
    • collection_date string(date) Required

      Date to check availability for in ISO 8601 format (YYYY-MM-DD)

    • location object Required

      Pickup location to check availability for

      Hide location attributes Show location attributes object
      • address_line_1 string Required

        Street address

        Minimum length is 1.

      • address_line_2 string | null

        Additional address info

      • city string Required

        City

        Minimum length is 1.

      • close_time string Required

        Location closing time in ISO 8601 format (HH:MM:SS)

      • country string Required

        Two-letter country code. Currently US and GB are supported.

        Minimum length is 2, maximum length is 2.

      • postal_code string Required

        Postal code

        Minimum length is 1.

      • region string | null

        State or province code

    • service object Required

      Carrier service to check availability for

      Hide service attributes Show service attributes object
      • carrier string Required

        Carrier identifier. fedex and dhl are supported.

        Values are fedex or dhl.

      • code string Required

        Service level code

        Values are ground or express.

      • route string Required

        Route type

        Values are domestic or international.

Responses

  • 200 application/json

    Available pickup slots for the given parameters

    Hide headers attributes Show headers attributes
    • content-type string
    • x-arta-request-id string

      A unique identifier for the Arta API call

    Hide response attributes Show response attributes object
    • availabilities array[object]

      Available pickup slots. May be empty if no slots are available.

      Hide availabilities attributes Show availabilities attributes object
      • collection_date string(date)

        Available pickup date (YYYY-MM-DD)

      • collection_times array[string]

        Available pickup times in ISO 8601 format (HH:MM:SS)

      • residential_available boolean

        Whether residential pickup is available

    • collection_date string(date)

      The date that was checked for availability (YYYY-MM-DD)

    • location object

      The pickup location that was checked

      Hide location attributes Show location attributes object
      • address_line_1 string

        Street address

      • address_line_2 string | null

        Additional address info

      • city string

        City

      • close_time string

        Location closing time in ISO 8601 format (HH:MM:SS)

      • country string

        Two-letter country code

      • postal_code string

        Postal code

      • region string

        State or province code

    • service object

      The carrier service that was checked

      Hide service attributes Show service attributes object
      • carrier string

        Carrier identifier

        Values are fedex or dhl.

      • code string

        Service level code

        Values are ground or express.

      • route string

        Route type

        Values are domestic or international.
  • 400 application/json

    Bad Request

    Hide headers attributes Show headers attributes
    • content-type string
    • x-arta-request-id string

      A unique identifier for the Arta API call

    Hide response attribute Show response attribute object
    • errors object
      Hide errors attribute Show errors attribute object
      • detail string
  • 403 application/json

    Forbidden

  • 422 application/json

    Unprocessable entity

    Hide response attribute Show response attribute object
    • errors object
      Hide errors attribute Show errors attribute object
      • detail string

        A human-readable explanation specific to this occurrence of the problem
POST /self_ship_collection_availability_checks 
curl \
 --request POST 'https://api.arta.io/self_ship_collection_availability_checks' \
 --header "Content-Type: application/json" \
 --header "Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y" \
 --data '{"self_ship_collection_availability_check":{"collection_date":"2026-03-06","location":{"address_line_1":"123 Main St","address_line_2":"string","city":"New York","close_time":"17:00:00","country":"US","postal_code":"10001","region":"NY"},"service":{"carrier":"fedex","code":"ground","route":"domestic"}}}'
Request examples 
# Headers
Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y

# Payload
{
  "self_ship_collection_availability_check": {
    "collection_date": "2026-03-06",
    "location": {
      "address_line_1": "123 Main St",
      "address_line_2": "string",
      "city": "New York",
      "close_time": "17:00:00",
      "country": "US",
      "postal_code": "10001",
      "region": "NY"
    },
    "service": {
      "carrier": "fedex",
      "code": "ground",
      "route": "domestic"
    }
  }
}
Response examples (200) 
# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx

# Payload
{
  "availabilities": [
    {
      "collection_date": "2026-03-06",
      "collection_times": [
        "07:00:00",
        "07:30:00",
        "08:00:00"
      ],
      "residential_available": true
    }
  ],
  "collection_date": "2026-03-06",
  "location": {
    "address_line_1": "123 Main St",
    "city": "New York",
    "close_time": "17:00:00",
    "country": "US",
    "postal_code": "10001",
    "region": "NY"
  },
  "service": {
    "carrier": "fedex",
    "code": "ground",
    "route": "domestic"
  }
}
Response examples (400) 
# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx

# Payload
{
  "errors": {
    "detail": "string"
  }
}
Response examples (422) 
{
  "errors": {
    "detail": "string"
  }
}