POST /api/v1/manifests.json

This API endpoint allows you to create a manifest. Please check the payload specification to make sure the required attributes are part of the payload and the optional attributes respect the specifications.

Supported Formats

json

Errors

Code Description
400 Bad Request
403 Forbidden
404 Not Found
422 Unprocessable Entity
500 Internal Server Error

Examples

curl "https://app.octopi.co/api/v1/manifests.json" -d '{ "voyage_id":"1234", "shipping_line":"Shipping Line Code" ,"manifest": {"client_identifier":"11223344"}}' -X POST -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: Token token=ADD TOKEN HERE"

Example Payload:

{
  "voyage_id": 123,
  "shipping_line": "Shipping line Code",
  "manifest": {
    "client_identifier": "client_id",
    "remarks": "We build API for manifest"
  }
}

Params

Param name Description
shipping_line
required

This must be a shipping line code that exists in Octopi.

Validations:

  • Must be a String
voyage_id
optional

This must be a voyage ID that exists in Octopi. Either voyage id or voyage number is required.

Validations:

  • Must be a Integer
voyage_number
optional

This must be a voyage number that exists in Octopi. Either voyage id or voyage number is required.

Validations:

  • Must be a String
manifest
optional

Validations:

  • Must be a Hash
manifest[client_identifier]
required

Validations:

  • Must be a String
manifest[remarks]
optional

Validations:

  • Must be a String
manifest[shipping_line_voyage_number]
optional

Notice the shipping_line_voyage_number param is the number that will be used in the EDI messages sent to the shipping line. Make sure this is the Voyage Number your shipping line is expecting. voyage_number param will be used if left blank.

Validations:

  • Must be a String