---
title: Subscribe Container
slug: subscribe-container
icon: 🛄
createdAt: 2022-08-17T10:30:36.000Z
---

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://tnt-api.rpalabs.io/api/v1/track_and_trace/ocean/containers/subscribe",
  "name": "Overview",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [
      {
        "kind": "required",
        "name": "Authorization",
        "type": "string",
        "children": [],
        "description": "Bearer access token from login api"
      }
    ],
    "bodyDataParameters": [
      {
        "kind": "required",
        "name": "carrier_code",
        "type": "string",
        "description": "carrier code of the specific cargo"
      },
      {
        "kind": "required",
        "name": "container_number",
        "type": "string",
        "description": "container number"
      },
      {
        "kind": "required",
        "name": "mbl_number",
        "type": "string",
        "description": "MBL number of the specific container"
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "vblFOfAhN7_OTbBducSAd",
        "code": "{\n  \"message\": \"Container was subscribed successfully\"\n}",
        "language": "200",
        "customLabel": ""
      },
      {
        "id": "0c_WlIRcGni2EgMtaqQTW",
        "code": "{\r\n    \"message\": \"We are sorry but we are not able to authenticate you. Please use access token from the login steps\",\r\n    \"status\": 401,\r\n    \"error_code\": 2\r\n}",
        "language": "401",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "vblFOfAhN7_OTbBducSAd"
  },
  "examples": {
    "languages": [
      {
        "id": "c4MFshqQc7D8XKvD3Li2v",
        "code": "curl --location --request POST 'https://tnt-api.rpalabs.io/api/v1/track_and_trace/ocean/containers/subscribe' \\\n--header 'Accept: application/json' \\\n--data-raw '{\"carrier_code\":\"string\",\"container_number\":\"string\",\"mbl_number\":\"string\"}'",
        "language": "curl",
        "customLabel": ""
      },
      {
        "id": "a1Ss3I8HorOJstAAjbr6B",
        "code": "var request = require('request');\nvar options = {\n   'method': 'POST',\n   'url': 'https://tnt-api.rpalabs.io/api/v1/track_and_trace/ocean/containers/subscribe',\n   'headers': {\n      'Accept': 'application/json'\n   },\n   body: '{\"carrier_code\":\"string\",\"container_number\":\"string\",\"mbl_number\":\"string\"}'\n\n};\nrequest(options, function (error, response) {\n   if (error) throw new Error(error);\n   console.log(response.body);\n});\n",
        "language": "nodejs",
        "customLabel": ""
      },
      {
        "id": "JOGXyPzn1WZrp_zqWvqTf",
        "code": "var myHeaders = new Headers();\nmyHeaders.append(\"Accept\", \"application/json\");\n\nvar raw = \"{\\\"carrier_code\\\":\\\"string\\\",\\\"container_number\\\":\\\"string\\\",\\\"mbl_number\\\":\\\"string\\\"}\";\n\nvar requestOptions = {\n   method: 'POST',\n   headers: myHeaders,\n   body: raw,\n   redirect: 'follow'\n};\n\nfetch(\"https://tnt-api.rpalabs.io/api/v1/track_and_trace/ocean/containers/subscribe\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));",
        "language": "javascript",
        "customLabel": ""
      },
      {
        "id": "xtYAuNkFCIbQVZA1766M9",
        "code": "import http.client\n\nconn = http.client.HTTPSConnection(\"tnt-api.rpalabs.io\")\npayload = \"{\\\"carrier_code\\\":\\\"string\\\",\\\"container_number\\\":\\\"string\\\",\\\"mbl_number\\\":\\\"string\\\"}\"\nheaders = {\n   'Accept': 'application/json'\n}\nconn.request(\"POST\", \"/api/v1/track_and_trace/ocean/containers/subscribe\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))",
        "language": "python",
        "customLabel": ""
      },
      {
        "id": "YhDMno5NF7lcGuDxmLOQ-",
        "code": "require \"uri\"\nrequire \"net/http\"\n\nurl = URI(\"https://tnt-api.rpalabs.io/api/v1/track_and_trace/ocean/containers/subscribe\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"Accept\"] = \"application/json\"\nrequest.body = \"{\\\"carrier_code\\\":\\\"string\\\",\\\"container_number\\\":\\\"string\\\",\\\"mbl_number\\\":\\\"string\\\"}\"\n\nresponse = https.request(request)\nputs response.read_body\n",
        "language": "ruby",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "c4MFshqQc7D8XKvD3Li2v"
  },
  "description": "This endpoint lets users to subscribe container and allows the container information to be stored in the database.",
  "currentNewParameter": {
    "label": "Header Parameter",
    "value": "headerParameters"
  }
}
```
:::

:::hint{type="danger"}
See the [Error Handling page](https://developers.rpalabs.io/error-handling) for troubleshooting any errors.
:::

### ✉️ Need some help?

If you encounter a problem or require assistance, please contact our support team with details regarding your request at [support@rippey.ai](support@rippey.ai). A representative will connect with you soon. 😊
