Packages

PKG101: Get Packages

get

Authorizations

Query parameters

pageinteger · min: 1Optional

Specifies the page number of the current dataset.

Default: 1

limitinteger · min: 1Optional

Specifies the row count of the current page.

Default: 10

numberstringOptional

Filter by exact value of the number field.

statusinteger · enumOptional

Filter by status field. Must be one of the provided integer values.

Possible values:

updated_atstring · date-timeOptional

Filters data where the "updated_at" field is exactly equal to a specified value.

updated_at__gtstring · date-timeOptional

Filters data where the "updated_at" field is greater than a specified value.

updated_at__gtestring · date-timeOptional

Filters data where the "updated_at" field is greater than or equal to a specified value.

updated_at__ltstring · date-timeOptional

Filters data where the "updated_at" field is less than a specified value.

updated_at__ltestring · date-timeOptional

Filters data where the "updated_at" field is less than or equal to a specified value.

created_atstring · date-timeOptional

Filters data where the "created_at" field is exactly equal to a specified value.

created_at__gtstring · date-timeOptional

Filters data where the "created_at" field is greater than a specified value.

created_at__gtestring · date-timeOptional

Filters data where the "created_at" field is greater than or equal to a specified value.

created_at__ltstring · date-timeOptional

Filters data where the "created_at" field is less than a specified value.

created_at__ltestring · date-timeOptional

Filters data where the "created_at" field is less than or equal to a specified value.

Header parameters

Accept-LanguagestringOptional

Specifies the communication language of the API.

Responses

200

OK

application/json

Responseall of

401

Unauthorized

application/json

500

Unexpected error.

get

HTTPcURLJavaScriptPython

GET /api/i2/packages/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "count": 1,
  "next": "https://seller-center.akinon.com/api/i2/resource?page=2&limit=10",
  "previous": null,
  "results": [
    {
      "number": "2595053219311870",
      "order_number": "2594887831811953",
      "status": 2,
      "shipping_address": {
        "email": "[e-mail]",
        "phone_number": "text",
        "first_name": "text",
        "last_name": "text",
        "country": "text",
        "country_code": "text",
        "city": "text",
        "township": "text",
        "district": "text",
        "line": "text",
        "postcode": "text",
        "company_name": "text",
        "tax_office": "text",
        "tax_no": "text",
        "e_bill_taxpayer": true,
        "identity_number": "text",
        "notes": "text"
      },
      "billing_address": {
        "email": "[e-mail]",
        "phone_number": "text",
        "first_name": "text",
        "last_name": "text",
        "country": "text",
        "country_code": "text",
        "city": "text",
        "township": "text",
        "district": "text",
        "line": "text",
        "postcode": "text",
        "company_name": "text",
        "tax_office": "text",
        "tax_no": "text",
        "e_bill_taxpayer": true,
        "identity_number": "text",
        "notes": "text"
      },
      "currency": "TRY",
      "amount": 99.99,
      "discount_amount": 9.99,
      "has_gift_box": true,
      "gift_box_note": "Happy Birthday!",
      "notes": "Please handle with care.",
      "date_placed": "2025-05-22T11:19:08.218Z",
      "shipping_method": "DHL - Standard",
      "shipping_company": {
        "name": "DHL",
        "slug": "dhl"
      },
      "is_requires_manual_entry": false,
      "waybill_number": "A456231",
      "tracking_number": "3457623412",
      "tracking_url": "https://akinon.com/track/3457623412",
      "shipment_date": "2025-05-22T11:19:08.218Z",
      "delivery_date": "2025-05-22T11:19:08.218Z",
      "invoice_date": "2025-05-22T11:19:08.218Z",
      "invoice_number": "IN-3457623412",
      "invoice_url": "https://akinon.com/invoice/IN-3457623412.pdf",
      "updated_at": "2025-05-22T11:19:08.218Z",
      "created_at": "2025-05-22T11:19:08.218Z"
    }
  ]
}

PKG102: Get Package Items

get

Authorizations

Path parameters

numberstringRequired

Unique identifier for the package.

Example: 2595053219311870

Query parameters

pageinteger · min: 1Optional

Specifies the page number of the current dataset.

Default: 1

limitinteger · min: 1Optional

Specifies the row count of the current page.

Default: 10

updated_atstring · date-timeOptional

Filters data where the "updated_at" field is exactly equal to a specified value.

updated_at__gtstring · date-timeOptional

Filters data where the "updated_at" field is greater than a specified value.

updated_at__gtestring · date-timeOptional

Filters data where the "updated_at" field is greater than or equal to a specified value.

updated_at__ltstring · date-timeOptional

Filters data where the "updated_at" field is less than a specified value.

updated_at__ltestring · date-timeOptional

Filters data where the "updated_at" field is less than or equal to a specified value.

created_atstring · date-timeOptional

Filters data where the "created_at" field is exactly equal to a specified value.

created_at__gtstring · date-timeOptional

Filters data where the "created_at" field is greater than a specified value.

created_at__gtestring · date-timeOptional

Filters data where the "created_at" field is greater than or equal to a specified value.

created_at__ltstring · date-timeOptional

Filters data where the "created_at" field is less than a specified value.

created_at__ltestring · date-timeOptional

Filters data where the "created_at" field is less than or equal to a specified value.

Header parameters

Accept-LanguagestringOptional

Specifies the communication language of the API.

Responses

200

OK

application/json

Responseall of

401

Unauthorized

application/json

404

Given resource or object is not found or available.

application/json

500

Unexpected error.

get

HTTPcURLJavaScriptPython

GET /api/i2/packages/{number}/items/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "count": 1,
  "next": "https://seller-center.akinon.com/api/i2/resource?page=2&limit=10",
  "previous": null,
  "results": [
    {
      "number": "2595053219311870-1",
      "status": 1,
      "product": "AKN-TSHRT-RD",
      "amount": 99.99,
      "discount_amount": 9.99,
      "tax_rate": 0.1,
      "has_reservation": true,
      "updated_at": "2025-05-22T11:19:08.218Z",
      "created_at": "2025-05-22T11:19:08.218Z"
    }
  ]
}

PKG103: Update Package

put

Authorizations

Path parameters

numberstringRequired

Unique identifier for the package.

Example: 2595053219311870

Header parameters

Accept-LanguagestringOptional

Specifies the communication language of the API.

Body

statusinteger · enumOptional

Status of the package:

• 2 - Preparing: The package is being prepared for shipment.
• 3 - Ready to Ship: The package is ready to be shipped.
• 4 - Shipped: The package has been shipped.
• 5 - Delivered: The package has been successfully delivered.
• 6 - Delivery Failed: The delivery of the package has failed.

Example: 3Possible values:

waybill_numberstringOptional

Unique identifier for the waybill associated with the package.

Example: A456231

tracking_numberstringOptional

Tracking number for monitoring the package's shipment progress.

Example: 3457623412

tracking_urlstring · uriOptional

URL for tracking the package online.

Example: https://akinon.com/track/3457623412

shipping_companystring · stringOptional

Name of the shipping company handling the package.

Example: DHL

shipment_datestring · date-timeOptional

Date and time when the package was shipped.

Example: 2022-01-01T12:00:00Z

delivery_datestring · date-timeOptional

Date and time when the package was delivered.

Example: 2022-01-02T12:00:00Z

invoice_datestring · date-timeOptional

Date and time when the invoice for the package was generated.

Example: 2022-01-01T12:00:00Z

invoice_numberstringOptional

Unique identifier or number associated with the package's invoice.

Example: IN-3457623412

invoice_urlstring · urlOptional

URL for the package's invoice.

Example: https://akinon.com/invoice/IN-3457623412.pdf

Responses

200

OK

application/json

400

Missing required field(s), invalid data or invalid action.

application/json

401

Unauthorized

application/json

404

Given resource or object is not found or available.

application/json

500

Unexpected error.

put

HTTPcURLJavaScriptPython

PUT /api/i2/packages/{number}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 358

{
  "status": 3,
  "waybill_number": "A456231",
  "tracking_number": "3457623412",
  "tracking_url": "https://akinon.com/track/3457623412",
  "shipping_company": "DHL",
  "shipment_date": "2022-01-01T12:00:00Z",
  "delivery_date": "2022-01-02T12:00:00Z",
  "invoice_date": "2022-01-01T12:00:00Z",
  "invoice_number": "IN-3457623412",
  "invoice_url": "https://akinon.com/invoice/IN-3457623412.pdf"
}

{
  "number": "2595053219311870",
  "order_number": "2594887831811953",
  "status": 2,
  "shipping_address": {
    "email": "[e-mail]",
    "phone_number": "text",
    "first_name": "text",
    "last_name": "text",
    "country": "text",
    "country_code": "text",
    "city": "text",
    "township": "text",
    "district": "text",
    "line": "text",
    "postcode": "text",
    "company_name": "text",
    "tax_office": "text",
    "tax_no": "text",
    "e_bill_taxpayer": true,
    "identity_number": "text",
    "notes": "text"
  },
  "billing_address": {
    "email": "[e-mail]",
    "phone_number": "text",
    "first_name": "text",
    "last_name": "text",
    "country": "text",
    "country_code": "text",
    "city": "text",
    "township": "text",
    "district": "text",
    "line": "text",
    "postcode": "text",
    "company_name": "text",
    "tax_office": "text",
    "tax_no": "text",
    "e_bill_taxpayer": true,
    "identity_number": "text",
    "notes": "text"
  },
  "currency": "TRY",
  "amount": 99.99,
  "discount_amount": 9.99,
  "has_gift_box": true,
  "gift_box_note": "Happy Birthday!",
  "notes": "Please handle with care.",
  "date_placed": "2025-05-22T11:19:08.218Z",
  "shipping_method": "DHL - Standard",
  "shipping_company": {
    "name": "DHL",
    "slug": "dhl"
  },
  "is_requires_manual_entry": false,
  "waybill_number": "A456231",
  "tracking_number": "3457623412",
  "tracking_url": "https://akinon.com/track/3457623412",
  "shipment_date": "2025-05-22T11:19:08.218Z",
  "delivery_date": "2025-05-22T11:19:08.218Z",
  "invoice_date": "2025-05-22T11:19:08.218Z",
  "invoice_number": "IN-3457623412",
  "invoice_url": "https://akinon.com/invoice/IN-3457623412.pdf",
  "updated_at": "2025-05-22T11:19:08.218Z",
  "created_at": "2025-05-22T11:19:08.218Z"
}

PKG104: Get Cargo Label

get

Authorizations

Path parameters

numberstringRequired

Unique identifier for the package.

Example: 2595053219311870

Header parameters

Accept-LanguagestringOptional

Specifies the communication language of the API.

Responses

200

OK

application/json

400

Missing required field(s), invalid data or invalid action.

application/json

401

Unauthorized

application/json

404

Given resource or object is not found or available.

application/json

500

Unexpected error.

get

HTTPcURLJavaScriptPython

GET /api/i2/packages/{number}/label/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": "text"
}

PKG105: Change Shipping Method

post

Authorizations

Path parameters

numberstringRequired

Unique identifier for the package.

Example: 2595053219311870

Header parameters

Accept-LanguagestringOptional

Specifies the communication language of the API.

Body

shipping_methodstring · uuidRequired

Unique identifier for the shipping method associated with the new package.

Example: 847b006e-000a-432e-b500-e3f49fa9ddcc

Responses

204

No Content

400

Missing required field(s), invalid data or invalid action.

application/json

401

Unauthorized

application/json

404

Given resource or object is not found or available.

application/json

500

Unexpected error.

post

HTTPcURLJavaScriptPython

POST /api/i2/packages/{number}/change-shipping-method/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "shipping_method": "847b006e-000a-432e-b500-e3f49fa9ddcc"
}

No content

PKG106: Split Package

post

Authorizations

Path parameters

numberstringRequired

Unique identifier for the package.

Example: 2595053219311870

Header parameters

Accept-LanguagestringOptional

Specifies the communication language of the API.

Body

itemsstring[]Required

Number of the package item to be split into a new package.

Example: 2595053219311870-1

shipping_methodstring · uuidOptional

Unique identifier for the shipping method associated with the new package. If not provided, the default shipping method is used.

Example: 847b006e-000a-432e-b500-e3f49fa9ddcc

Responses

204

No Content

400

Missing required field(s), invalid data or invalid action.

application/json

401

Unauthorized

application/json

404

Given resource or object is not found or available.

application/json

500

Unexpected error.

post

HTTPcURLJavaScriptPython

POST /api/i2/packages/{number}/split/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 91

[
  {
    "items": [
      "2595053219311870-1"
    ],
    "shipping_method": "847b006e-000a-432e-b500-e3f49fa9ddcc"
  }
]

No content

PKG107: Reject Package

post

Authorizations

Path parameters

numberstringRequired

Unique identifier for the package.

Example: 2595053219311870

Header parameters

Accept-LanguagestringOptional

Specifies the communication language of the API.

Body

itemsstring[]Required

Number of the package item to be rejected.

Example: 2595053219311870-1

reasonstringRequired

Reason for rejecting the package item.

Example: Unsupplied

Responses

204

No Content

400

Missing required field(s), invalid data or invalid action.

application/json

401

Unauthorized

application/json

404

Given resource or object is not found or available.

application/json

500

Unexpected error.

post

HTTPcURLJavaScriptPython

POST /api/i2/packages/{number}/reject/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "items": [
    "2595053219311870-1"
  ],
  "reason": "Unsupplied"
}

No content

PKG108: Release Stock Reservation by Package Item

delete

Authorizations

Path parameters

numberstringRequired

Unique identifier for the package.

Example: 2595053219311870

item-numberstringRequired

Unique identifier for the package item.

Example: 2595053219311870-1

Header parameters

Accept-LanguagestringOptional

Specifies the communication language of the API.

Responses

204

No Content

400

Missing required field(s), invalid data or invalid action.

application/json

401

Unauthorized

application/json

404

Given resource or object is not found or available.

application/json

500

Unexpected error.

delete

HTTPcURLJavaScriptPython

DELETE /api/i2/packages/{number}/reservations/{item-number} HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

No content