AfterShip Cancel Labels API

The Cancel Labels API from AfterShip — 2 operation(s) for cancel labels.

Operations 3

GET /cancel-labels Get the cancelled labels #
POST /cancel-labels Cancel a label #
GET /cancel-labels/{id} Get a cancelled label #

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/aftership-cancel-labels-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 email required.

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

OpenAPI Specification

aftership-cancel-labels-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Overview Cancel Labels API
  version: '1.0'
  summary: API Overview
  contact:
    name: AfterShip Support
    url: https://www.aftership.com/contact-us
    email: support@aftership.com
  termsOfService: https://www.aftership.com/legal/terms-of-service
  description: '> OAS Schema can be downloaded [here](https://stoplight.io/api/v1/projects/automizely/docs-core-postmenapi-com/nodes/reference/api.v3.json?branch=master&deref=optimizedBundle)'
servers:
- description: Sandbox
  url: https://sandbox-api.aftership.com/postmen/v3
- url: https://api.aftership.com/postmen/v3
  description: Production
security:
- as-api-key: []
tags:
- name: Cancel Labels
paths:
  /cancel-labels:
    parameters: []
    get:
      summary: Get the cancelled labels
      responses:
        '200':
          description: Get cancelled labels object.
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  example-1:
                    meta:
                      code: 200
                      message: OK
                      details: []
                    data:
                      next_token: eyJjcmVhdGVkX2F0IjoiMjAxNS0000000000Njo1MjozNC4zNjFaIiwiaWQiOiIwNGZlNDgz0000000000QxYzItYWUxOC1kNTEzZjNmMWNmMWEiLCJ1c2Vy0000000000RjNDY4NTAtNjIyNS00ZTBiLTg5ZTQtZTM3N2M3YWM5ZDk4In0=
                      limit: 20
                      created_at_min: '2015-11-26T08:58:59+00:00'
                      created_at_max: '2015-11-27T08:58:59+00:00'
                      cancel-labels:
                      - id: 0e37b87a-684e-43cd-aaba-f0718e066519
                        status: cancelled
                        label:
                          id: 166218cd-3e0a-4753-ac26-89ddabcd1dda
                        created_at: '2015-11-27T08:55:13+00:00'
                        updated_at: '2015-11-27T08:55:14+00:00'
                      - id: d05971fb-fddf-4243-ad58-7f34401b1da9
                        status: cancelled
                        label:
                          id: 0426d03a-ae0d-4818-801c-4e92b31450da
                        created_at: '2015-11-27T08:52:35+00:00'
                        updated_at: '2015-11-27T08:52:37+00:00'
                      - id: cb404620-890b-4d37-9692-34ea08c4f111
                        status: cancelled
                        label:
                          id: df5769b0-60d0-4daf-8bad-bd164d64e12b
                        created_at: '2015-11-27T08:52:08+00:00'
                        updated_at: '2015-11-27T08:52:09+00:00'
                      - id: 5472583e-3e55-492f-b1ab-5208de524e4e
                        status: cancelled
                        label:
                          id: 72393fe3-be8e-4a7a-8434-1f0b5b56c09e
                        created_at: '2015-11-27T08:47:01+00:00'
                        updated_at: '2015-11-27T08:47:02+00:00'
                      - id: d4811447-fa1b-42a9-9820-09dfd57ed8e0
                        status: cancelled
                        label: null
                        created_at: '2015-11-27T08:41:05+00:00'
                        updated_at: '2015-11-27T08:41:05+00:00'
                      - id: 28e02aea-cd0c-4553-8a63-52bc98c29420
                        status: cancelled
                        label:
                          id: b3d75a21-9d27-4b1b-9592-485667f59e3f
                        created_at: '2015-11-27T08:25:12+00:00'
                        updated_at: '2015-11-27T08:25:13+00:00'
                      - id: 39b4be71-f3d8-4d33-be15-fbf7be0b41d0
                        status: cancelled
                        label:
                          id: d88e9447-c84e-4e97-8d1f-ba98038a7a9e
                        created_at: '2015-11-27T08:22:35+00:00'
                        updated_at: '2015-11-27T08:22:37+00:00'
                      - id: 6941fcfa-6e14-406c-9e9f-4a6f4fb550c1
                        status: cancelled
                        label:
                          id: 2d4caaf4-1231-412d-bb94-62bae88ba785
                        created_at: '2015-11-27T08:22:09+00:00'
                        updated_at: '2015-11-27T08:22:09+00:00'
                      - id: 263123da-c0c0-4fd1-bf1d-3936a788d272
                        status: cancelled
                        label:
                          id: 9fc1f61b-7542-4015-a3dd-5dc4d4e8689b
                        created_at: '2015-11-27T08:17:00+00:00'
                        updated_at: '2015-11-27T08:17:01+00:00'
                      - id: 38b34575-2081-4333-8779-78cab4d9a642
                        status: cancelled
                        label: null
                        created_at: '2015-11-27T08:11:04+00:00'
                        updated_at: '2015-11-27T08:11:04+00:00'
                      - id: 2944f236-6420-4f9f-8c20-b06daaf39f39
                        status: cancelled
                        label:
                          id: b05b2f29-9ed1-4844-90f6-a1ff13af56bb
                        created_at: '2015-11-27T07:55:12+00:00'
                        updated_at: '2015-11-27T07:55:13+00:00'
                      - id: 0c074025-c4d9-47ce-bb89-ae854abe1a1b
                        status: cancelled
                        label:
                          id: 04b151b1-deb1-41e8-afbe-726df8a7ff54
                        created_at: '2015-11-27T07:52:37+00:00'
                        updated_at: '2015-11-27T07:52:38+00:00'
                      - id: 7c78c2a8-0ff0-4c80-bb99-9ae9037034e4
                        status: cancelled
                        label:
                          id: 2afe41d0-70fe-4130-8e76-8d305e1f15dc
                        created_at: '2015-11-27T07:47:02+00:00'
                        updated_at: '2015-11-27T07:47:02+00:00'
                      - id: a0dd6cd0-00c6-4502-ba45-73369a010ca7
                        status: cancelled
                        label: null
                        created_at: '2015-11-27T07:41:04+00:00'
                        updated_at: '2015-11-27T07:41:04+00:00'
                      - id: 78e50de5-f5e9-455c-922d-2de14fe91952
                        status: cancelled
                        label:
                          id: b09f1969-e77f-42dc-94d0-32fe5d4b3337
                        created_at: '2015-11-27T07:25:13+00:00'
                        updated_at: '2015-11-27T07:25:14+00:00'
                      - id: a4a13f7a-66b1-410c-824c-b9edf9aada3a
                        status: cancelled
                        label:
                          id: 9f783f53-c336-4de7-ad6d-b617614ba269
                        created_at: '2015-11-27T07:22:35+00:00'
                        updated_at: '2015-11-27T07:22:36+00:00'
                      - id: f3a97cbe-8792-478c-bfc2-7ab9be026760
                        status: cancelled
                        label:
                          id: 7350085b-a11c-4b63-874e-15a542ee73d2
                        created_at: '2015-11-27T07:17:00+00:00'
                        updated_at: '2015-11-27T07:17:00+00:00'
                      - id: 0f3f06c6-b52d-4fcb-a6a9-7f606991d79c
                        status: cancelled
                        label: null
                        created_at: '2015-11-27T07:11:04+00:00'
                        updated_at: '2015-11-27T07:11:04+00:00'
                      - id: 371186a1-67f3-434c-af79-18ce78ece73e
                        status: cancelled
                        label:
                          id: 1e0af41f-e3d8-42ce-958c-117ebb72ebc5
                        created_at: '2015-11-27T06:55:13+00:00'
                        updated_at: '2015-11-27T06:55:13+00:00'
                      - id: 04fe4835-8527-41c2-ae18-d513f3f1cf1a
                        status: cancelled
                        label:
                          id: f6a3d017-dd7f-42b9-abeb-c8104c130e0a
                        created_at: '2015-11-27T06:52:34+00:00'
                        updated_at: '2015-11-27T06:52:35+00:00'
                properties:
                  meta:
                    $ref: '#/components/schemas/Meta.v3'
                  data:
                    type: object
                    properties:
                      next_token:
                        type: string
                      limit:
                        type: integer
                      created_at_min:
                        type: string
                      created_at_max:
                        type: string
                      cancel_labels:
                        type: array
                        description: The array contains cancel_lebels object information. Please refer to [cancel label](../model/resource/cancel_label.v3.json) object for details.
                        items:
                          $ref: '#/components/schemas/Cancel_label.v3'
              examples:
                get cancel label response:
                  value:
                    meta:
                      code: 200
                      message: OK
                      details: []
                    data:
                      next_token: eyJjcmVhdGVkX2F0IjoiMjAxNS0000000000Njo1MjozNC4zNjFaIiwiaWQiOiIwNGZlNDgz0000000000QxYzItYWUxOC1kNTEzZjNmMWNmMWEiLCJ1c2Vy0000000000RjNDY4NTAtNjIyNS00ZTBiLTg5ZTQtZTM3N2M3YWM5ZDk4In0=
                      limit: 20
                      created_at_min: '2022-02-26T08:58:59+00:00'
                      created_at_max: '2022-02-27T08:58:59+00:00'
                      cancel-labels:
                      - id: 0e37b87a-684e-43cd-aaba-f0718e066519
                        status: cancelled
                        label:
                          id: 166218cd-3e0a-4753-ac26-89ddabcd1dda
                        created_at: '2022-02-27T08:55:13+00:00'
                        updated_at: '2022-02-27T08:55:14+00:00'
                      - id: d05971fb-fddf-4243-ad58-7f34401b1da9
                        status: cancelled
                        label:
                          id: 0426d03a-ae0d-4818-801c-4e92b31450da
                        created_at: '2022-02-27T08:52:35+00:00'
                        updated_at: '2022-02-27T08:52:37+00:00'
      operationId: get-cancel-labels
      description: 'Get all the cancelled labels.

        <div style="visibility:hidden; height: 0">

        The array contains cancel_lebels object information. Please refer to [cancel label](../model/resource/cancel_label.v3.json) object for details.

        </div>'
      parameters:
      - schema:
          type: string
        in: query
        name: shipper_account_id
        description: Shipper account ID
      - schema:
          type: string
          enum:
          - cancelling
          - cancelled
          - failed
        in: query
        name: status
        description: Cancel Label status
      - schema:
          type: string
        in: query
        name: limit
        description: Number of records per page
      - schema:
          type: string
        in: query
        name: created_at_min
        description: 'Start date and time of the record created (format YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS+00:00, default: 24hrs ago)'
      - schema:
          type: string
        in: query
        name: created_at_max
        description: 'End date and time of the record created (format YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS+00:00, default: NOW())'
      - schema:
          type: string
        in: query
        name: next_token
        description: Next token
      - schema:
          type: string
          default: application/json
          example: application/json
        in: header
        name: Content-Type
        description: Content-Type
        required: true
      x-internal: false
      tags:
      - Cancel Labels
      security:
      - as-api-key: []
    post:
      summary: Cancel a label
      operationId: post-cancel-labels
      responses:
        '200':
          description: Cancel a label.
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  example-1:
                    meta:
                      code: 200
                      message: OK
                      details: []
                    data:
                      id: 00000000-0000-0000-0000-000000000000
                      status: cancelled
                      label:
                        id: 00000000-0000-0000-0000-000000000000
                      created_at: '2015-11-20T09:13:09+00:00'
                      updated_at: '2015-11-20T09:13:09+00:00'
                properties:
                  meta:
                    $ref: '#/components/schemas/Meta.v3'
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      status:
                        type: string
                        enum:
                        - cancelling
                        - cancelled
                        - failed
                      refund_status:
                        type: string
                      label:
                        type: object
                        properties:
                          id:
                            type: string
                      created_at:
                        type: string
                      updated_at:
                        type: string
              examples:
                example-1:
                  value:
                    meta:
                      code: 200
                      type: OK
                      message: Everything worked as expected.
                    data:
                      id: 00000000-0000-0000-0000-000000000000
                      status: cancelled
                      label:
                        id: 00000000-0000-0000-0000-000000000000
                      created_at: '2022-02-11T08:10:47+00:00'
                      updated_at: '2022-02-11T08:10:47+00:00'
      description: Cancel a label.
      parameters:
      - schema:
          type: string
          default: application/json
          example: application/json
        in: header
        name: Content-Type
        description: Content-Type
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-examples:
                example-1:
                  label:
                    id: 00000000-0000-0000-0000-000000000000
              properties:
                label:
                  type: object
                  properties:
                    id:
                      type: string
            examples:
              example-1:
                value:
                  label:
                    id: 00000000-0000-0000-0000-000000000000
          application/xml:
            schema:
              type: object
              properties: {}
        description: Cancel a label.
      tags:
      - Cancel Labels
      security:
      - as-api-key: []
  /cancel-labels/{id}:
    parameters:
    - schema:
        type: string
      name: id
      in: path
      required: true
      description: Cancel label id
    get:
      summary: Get a cancelled label
      responses:
        '200':
          description: Get a cancelled label.
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  example-1:
                    meta:
                      code: 200
                      message: OK
                      details: []
                    data:
                      id: 00000000-0000-0000-0000-000000000000
                      status: cancelled
                      label: null
                      created_at: '2015-11-20T09:13:09+00:00'
                      updated_at: '2015-11-20T09:13:09+00:00'
                properties:
                  meta:
                    $ref: '#/components/schemas/Meta.v3'
                  data:
                    $ref: '#/components/schemas/Cancel_label.v3'
              examples:
                example-1:
                  value:
                    meta:
                      code: 200
                      message: OK
                      details: []
                    data:
                      id: 00000000-0000-0000-0000-000000000000
                      status: cancelled
                      label:
                        id: 00000000-0000-0000-0000-000000000000
                      created_at: '2015-11-20T09:13:09+00:00'
                      updated_at: '2015-11-20T09:13:09+00:00'
      operationId: get-cancel-label
      description: Get a cancelled label.
      parameters:
      - schema:
          type: string
          default: application/json
          example: application/json
        in: header
        name: Content-Type
        description: Content-Type
        required: true
      tags:
      - Cancel Labels
      security:
      - as-api-key: []
components:
  schemas:
    Meta.v3:
      description: Meta data object.
      type: object
      x-examples: {}
      examples:
      - code: 200
        type: OK
        message: Everything worked as expected.
      title: Meta
      x-tags:
      - Envelope
      properties:
        code:
          type: integer
          description: Code of Meta
        message:
          type: string
          description: Message of Meta
        details:
          type: array
          description: Details of Meta
          items:
            $ref: '#/components/schemas/Error.v3'
        retryable:
          type: boolean
          description: Whether this request will be retryable or not
      required:
      - code
      - message
    Cancel_label.v3:
      title: CancelLabel
      x-stoplight:
        id: z2mr6rgdbtram
      type: object
      description: 'Cancel Label object: the description of cancel label object'
      x-tags:
      - Resource
      examples: []
      properties:
        id:
          type: string
        status:
          type: string
          enum:
          - cancelling
          - cancelled
          - failed
        label:
          $ref: '#/components/schemas/Reference.v3'
        created_at:
          type: string
          description: the timestamp of created_at
          example: '2022-05-18T09:17:38+00:00'
        updated_at:
          type: string
          example: '2022-05-18T09:17:38+00:00'
          description: the timestamp of updated_at
    Reference.v3:
      title: Reference
      x-stoplight:
        id: pwqp1323bhe8q
      type: object
      properties:
        id:
          type: string
          description: 'id of referring object

            '
      x-tags:
      - Primitive
      examples: []
      description: 'Reference object: the description of reference information'
    Error.v3:
      type: object
      title: Error
      description: Each error object contains a "path" key and an "info" key. The "path" is the JSON path of the request object to indicate the error location. The "info" is a human-readable description of the error.
      examples:
      - path: data.shipment.ship_from.country
        info: data.shipment.ship_from.country is a required property
      additionalProperties: false
      x-tags:
      - Envelope
      properties:
        path:
          type: string
          description: The json path of the request object to indicate the error location
          example: account.email
        info:
          type: string
          description: A human-readable description of the error.
          example: account.email is invalid
  securitySchemes:
    as-api-key:
      name: as-api-key
      type: apiKey
      in: header