List container party roles
curl --request GET \
--url https://api.terminal49.com/v2/containers/{container_id}/party_roles \
--header 'Authorization: <api-key>'import requests
url = "https://api.terminal49.com/v2/containers/{container_id}/party_roles"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.terminal49.com/v2/containers/{container_id}/party_roles', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.terminal49.com/v2/containers/{container_id}/party_roles",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.terminal49.com/v2/containers/{container_id}/party_roles"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.terminal49.com/v2/containers/{container_id}/party_roles")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.terminal49.com/v2/containers/{container_id}/party_roles")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "1d0f2a0e-5c3b-4c7e-9a52-3b6f8d2e4a11",
"type": "party_role",
"attributes": {
"role": "pickup_dray_carrier",
"roleable_type": "Cargo",
"roleable_id": "8f0c6b1a-2d4e-4f7b-9c3a-5e6d7f8a9b0c",
"created_at": "2026-09-01T14:02:11Z",
"updated_at": "2026-09-01T14:02:11Z"
},
"relationships": {
"party": {
"data": {
"id": "ba4cb904-827f-4038-8e31-1e92b3356218",
"type": "party"
}
}
}
}
],
"included": [
{
"id": "ba4cb904-827f-4038-8e31-1e92b3356218",
"type": "party",
"attributes": {
"company_name": "ACME LOGISTICS",
"nickname": "ACME"
}
}
],
"links": {
"self": "/v2/containers/8f0c6b1a-2d4e-4f7b-9c3a-5e6d7f8a9b0c/party_roles"
}
}{
"errors": [
{
"detail": "<string>",
"title": "<string>",
"source": {
"pointer": "<string>",
"parameter": "<string>"
},
"code": "<string>",
"status": "<string>",
"meta": {}
}
]
}{
"errors": [
{
"status": "404",
"title": "Not Found"
}
]
}Party Roles
List container party roles
List the party roles on a container in the Terminal49 API. Returns each role, such as pickup dray carrier, with the linked party in included.
GET
/
containers
/
{container_id}
/
party_roles
List container party roles
curl --request GET \
--url https://api.terminal49.com/v2/containers/{container_id}/party_roles \
--header 'Authorization: <api-key>'import requests
url = "https://api.terminal49.com/v2/containers/{container_id}/party_roles"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.terminal49.com/v2/containers/{container_id}/party_roles', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.terminal49.com/v2/containers/{container_id}/party_roles",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.terminal49.com/v2/containers/{container_id}/party_roles"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.terminal49.com/v2/containers/{container_id}/party_roles")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.terminal49.com/v2/containers/{container_id}/party_roles")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "1d0f2a0e-5c3b-4c7e-9a52-3b6f8d2e4a11",
"type": "party_role",
"attributes": {
"role": "pickup_dray_carrier",
"roleable_type": "Cargo",
"roleable_id": "8f0c6b1a-2d4e-4f7b-9c3a-5e6d7f8a9b0c",
"created_at": "2026-09-01T14:02:11Z",
"updated_at": "2026-09-01T14:02:11Z"
},
"relationships": {
"party": {
"data": {
"id": "ba4cb904-827f-4038-8e31-1e92b3356218",
"type": "party"
}
}
}
}
],
"included": [
{
"id": "ba4cb904-827f-4038-8e31-1e92b3356218",
"type": "party",
"attributes": {
"company_name": "ACME LOGISTICS",
"nickname": "ACME"
}
}
],
"links": {
"self": "/v2/containers/8f0c6b1a-2d4e-4f7b-9c3a-5e6d7f8a9b0c/party_roles"
}
}{
"errors": [
{
"detail": "<string>",
"title": "<string>",
"source": {
"pointer": "<string>",
"parameter": "<string>"
},
"code": "<string>",
"status": "<string>",
"meta": {}
}
]
}{
"errors": [
{
"status": "404",
"title": "Not Found"
}
]
}Returns every party role on the container. The linked parties are returned in
included.
Path parameters
| Parameter | Required | Description |
|---|---|---|
container_id | Yes | The ID of the container |
Authorizations
Use a Terminal49 API key in the Authorization header with the Token prefix.
Authorization: Token YOUR_API_KEY
Path Parameters
Container ID
Response
OK
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Pagination links. Each value is an absolute URL. self repeats the request URL as sent, including its query string and its encoding. current, first, prev, next, and last repeat the request's query parameters, with page[number] and page[size] in unencoded brackets.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Was this page helpful?