GET /api/v1/containers/:container_number/holds.json

Supported Formats

json

Errors

Code	Description
404	Not found
409	Conflict
500	Server crashed for some reason

Examples

This endpoint returns a list of holds that have been placed on the container.

curl "https://app.octopi.co/api/v1/containers/ADD CONTAINER NUMBER HERE/holds.json" -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: Token token=YOURTOKEN"

{
  "holds": [
    {
      "lifted": false,
      "applied_at": null,
      "lifted_at": null,
      "lifted_until": null,
      "lifted_by": null,
      "hold_type": "DETENTION HOLD",
      "actions": {
        "lift": {
          "method": "PUT",
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds/51359/lift.json"
        },
        "index": {
          "method": "GET",
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds.json"
        }
      },
      "id": 51359,
      "reference_number": null,
      "applied_by": null
    },
    {
      "lifted_at": null,
      "lifted_until": null,
      "lifted_by": null,
      "lifted": false,
      "applied_at": null,
      "applied_by": null,
      "actions": {
        "index": {
          "method": "GET",
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds.json"
        },
        "lift": {
          "method": "PUT",
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds/51360/lift.json"
        }
      },
      "hold_type": "GATE MOVE INVOICE FEE",
      "reference_number": null,
      "id": 51360
    },
    {
      "applied_by": null,
      "actions": {
        "index": {
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds.json",
          "method": "GET"
        },
        "lift": {
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds/51361/lift.json",
          "method": "PUT"
        }
      },
      "hold_type": "CUSTOMS INVOICE FEE",
      "reference_number": null,
      "id": 51361,
      "lifted_at": null,
      "lifted_until": null,
      "lifted_by": null,
      "lifted": false,
      "applied_at": null
    },
    {
      "lifted_at": null,
      "lifted_until": null,
      "lifted_by": null,
      "lifted": false,
      "applied_at": null,
      "applied_by": null,
      "actions": {
        "index": {
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds.json",
          "method": "GET"
        },
        "lift": {
          "method": "PUT",
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds/51362/lift.json"
        }
      },
      "hold_type": "PORT AUTHORITY INVOICE FEE",
      "reference_number": null,
      "id": 51362
    },
    {
      "applied_by": null,
      "actions": {
        "index": {
          "method": "GET",
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds.json"
        },
        "lift": {
          "method": "PUT",
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds/51363/lift.json"
        }
      },
      "hold_type": "SPECIAL HOLD",
      "reference_number": null,
      "id": 51363,
      "lifted_at": null,
      "lifted_by": null,
      "lifted_until": null,
      "lifted": false,
      "applied_at": null
    },
    {
      "lifted_at": null,
      "lifted_by": null,
      "lifted_until": null,
      "lifted": false,
      "applied_at": null,
      "applied_by": null,
      "actions": {
        "index": {
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds.json",
          "method": "GET"
        },
        "lift": {
          "url": "https://app.octopi.co/api/v1/containers/BMOU4286229/holds/51364/lift.json",
          "method": "PUT"
        }
      },
      "hold_type": "MAINTENANCE HOLD",
      "reference_number": null,
      "id": 51364
    }
  ]
}

Params

Param name	Description
container_number required	Validations: Must be a String