GET /self_ship_collections

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.

Retrieve a paginated collection of self-ship collection records belonging to your organization, sorted by most recent first

Headers

  • Authorization string Required

    Authorize your API calls with an Arta API token

Query parameters

  • page integer

    Page number of the results to fetch.

    Default value is 1.

  • page_size integer

    Results per page (max 50)

    Default value is 20.

Responses

  • 200 application/json

    A collection of Self-Ship Collection records

    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
    • items array[object]
      Hide items attributes Show items attributes object
      • closed_at string | null

        A NaiveDatetime-formatted timestamp describing when the collection was closed

      • collection_date string(date)

        The pickup date in ISO 8601 format (YYYY-MM-DD).

      • collection_time string

        The pickup time in ISO 8601 format (HH:MM:SS).

      • created_at string

        A NaiveDatetime-formatted timestamp describing when the resource was created with microsecond precision

      • id string(uuid)

        The ID of the self-ship collection in UUID format

      • location object

        The pickup location details

        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)

        • contact object

          Contact at the pickup location

          Hide contact attributes Show contact attributes object
          • email_address string

            Contact email address

          • name string

            Contact name

          • phone_number string

            Contact phone number

        • country string

          Two-letter country code

        • package_location string

          Where packages are located at the pickup location

          Values are front, none, rear, or side.

        • postal_code string

          Postal code

        • region string

          State or province code

      • service object

        Carrier service details

        Hide service attributes Show service attributes object
        • carrier string

          Carrier identifier

          Value is fedex.

        • code string

          Service level code

          Values are express or ground.

        • route string

          Route type

          Values are domestic or international.

      • shortcode string

        A human-readable identifier for the collection, formatted as the organization's shortcode followed by a hyphen and six alphanumeric characters

        Format should match the following pattern: ^[A-Z]+-[A-Z0-9]{6}$.

      • status string

        The current status of the collection

        Values are scheduled, closed, cancelled, or incomplete.

      • updated_at string

        A NaiveDatetime-formatted timestamp describing when the resource was last updated with microsecond precision

    • metadata object
      Hide metadata attributes Show metadata attributes object
      • page integer(int64)
      • page_size integer(int64)
      • total_count integer(int64)
GET /self_ship_collections
curl \
 --request GET 'https://api.arta.io/self_ship_collections' \
 --header "Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y"
Response examples (200)
# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx

# Payload
{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "scheduled",
      "service": {
        "code": "express",
        "route": "domestic",
        "carrier": "fedex"
      },
      "location": {
        "city": "New York",
        "region": "NY",
        "contact": {
          "name": "John Doe",
          "phone_number": "+1-555-123-4567",
          "email_address": "john@example.com"
        },
        "country": "US",
        "close_time": "17:00:00",
        "postal_code": "10001",
        "address_line_1": "123 Main St",
        "address_line_2": null,
        "package_location": "front"
      },
      "closed_at": null,
      "shortcode": "ACME-S3GP24",
      "created_at": "2026-03-01T12:00:00.000000",
      "updated_at": "2026-03-01T12:00:00.000000",
      "collection_date": "2026-03-06",
      "collection_time": "10:00:00"
    }
  ],
  "metadata": {
    "page": 1,
    "page_size": 20,
    "total_count": 1
  }
}