Get Labels

The Labels API provides the capability of retrieving FedEx labels for a given label ID.

Swagger

			
swagger: '2.0'
info:
  x-ibm-name: label
  title: Label
  version: 1.0.0
schemes:
  - https
host: $(catalog.host)
basePath: /v1
consumes:
  - application/json
produces:
  - application/json
securityDefinitions:
  oauth2:
    type: oauth2
    description: ''
    flow: accessCode
    authorizationUrl: 'https://<............................>/fsc/oauth2/authorize'
    scopes:
      Fulfillment_Returns: ''
    tokenUrl: 'https://<............................>/fsc/oauth2/token'
  Client_Secret:
    type: apiKey
    description: Enter Client Secret
    in: header
    name: X-IBM-Client-Secret
  Client_Id:
    type: apiKey
    in: header
    name: X-IBM-Client-Id
    description: Enter Client ID
security:
  - Client_Id: []
    Client_Secret: []
    oauth2:
      - Fulfillment_Returns
x-ibm-configuration:
  testable: true
  enforced: true
  phase: realized
paths:
  /labels/{labelId}:
    get:
      responses:
        '200':
        description: 200 OK      
    deprecated: false
    parameters:    
    - name: accessToken
      type: string
      required: false
      in: header
      description: 'Enter AccessToken, it is mandatory.'
    - name: labelId
      type: string
      required: true
        in: path
        description: '12701'
		summary: Label
		description: The Labels API provides the capability of retrieving FedEx labels for a given label ID.
			
		

Sample Request

			
	•	Retrieve all lables details using lableId
	https://<........>/api/v1/labels/15701
				Request Header	Accept: application/pdf.

					
				
			
		

Sample Response

Success Response

			Response will be the PDF file.
		

Sample Request

			
	•	Retrieve all lables details using lableId
	https://<........>/api/v1/labels/15701
				Request Header	No request header specified.

					
				
			
		

Sample Response

Success Response

			{
  "requestIdentifier" : "COM1482178",
  "transactionDate" : "2014-01-09T13:31:00-05:00",
  "status" : true,
  "labels" : [{
    "id" : "23094",
    "trackingNumber" : "79405496348",
    "labelContent" : "<…BASE64 CONTENT…>"
  },{
    "id" : "23095",
    "trackingNumber" : "79405496349",
    "labelContent" : "<…BASE64 CONTENT…>"
  }],
  "errors" : [{
      "code" : "ERR-LBL-0001",
      "description" : "Something went wrong"
    }
  ]
}
			
		

OAuth 2.0

HTTP Headers Description
Authorization You must always provide the access token for authorization to access the API.

HTTP-Header       Value
Authorization       Bearer accessToken
Origin Origin URL.

HTTP-Header       Value
Origin                domain.com

Custom authentication

HTTP Headers Description
X-IBM-Client-Id You must always provide in the HTTP header your API portal application's client ID (X-IBM-Client-Id) to access the API.

HTTP-Header       Value
X-IBM-Client-Id     ************
X-IBM-Client-Secret You must always provide in the HTTP header your API portal application's client secret (X-IBM-Client-Secret) to access the API.

HTTP-Header       Value
X-IBM-Client-Secret     ************
AccessToken Application Access Token
Origin Origin URL.

HTTP-Header       Value
Origin                domain.com

Query Parameters

Parameter Data type Description Required
labelId String Label ID. Only one value is allowed. Y

Response Attribute

Parameter Data type Description
requestIdentifier String Request identifier.
transactionDate Date Transaction date/time.
UTC Format: 2014-01-09T13:31:00-05:00
success boolean Status of the transaction
Valid Values: True or False
labels[]    
id String Label ID.
trackingNumber String Tracking number for this label.
labelContent String Base64 encoded string of the label PDF file.
errors[]    
code String Code associated with the error.
description String Description of the error.

HTTP Status Code

Code Description
200 OK - HTTP Response for successfully processed requests
400 Bad Request.
403 Forbidden
404 Not Found - Server couldn’t find anything matching request URI
500 Internal Server Error – Unable to process the request

Error Code

Code Description
ERR-SYS-0001 Your request cannot be processed due to a system error.
ERR-CMR-0001 Input data validation failed.
ERR-CMR-0002 Authentication Failed. Invalid Access Token.
ERR-CMR-0003 Missing mandatory fields.
ERR-LBL-0001 Label ID is missing
ERR-LBL-0002 Only one Label ID can be present when requesting PDF
ERR-LBL-0003 Cannot find label with given ID
ERR-LBL-0004 Retailer ID is missing