List trailer documents

GET

api

{version}

trailers

{trailerId}

documents

List trailer documents

curl --request GET \
  --url https://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents",
  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: Bearer <token>"
  ],
]);

$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://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

[
  {
    "id": "<string>",
    "AttachmentPath": "<string>",
    "AttachmentType": "<string>",
    "ParentId": "<string>",
    "ParentType": "<string>",
    "AttachmentSize": 123,
    "UploadedAt": "2023-11-07T05:31:56Z",
    "UploadedBy": "<string>",
    "DownloadUrl": "<string>",
    "ExpiresAt": "2023-11-07T05:31:56Z"
  }
]

{
  "Errors": {},
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

Retrieve all uploaded documents associated with a specific Trailer by its unique trailerId.

Request Parameters

Parameter	Type	Required	Description
version	String	Yes	API version to use.
trailerId	String	Yes	Unique identifier of the trailer.

Example cURL Request

curl --location 'https://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Replace {version} with the API version, {trailerId} with the actual trailer ID, and YOUR_ACCESS_TOKEN with a valid token.

Response Body

Array of document objects:

Name	Type	Description
id	string	Unique identifier of the document.
AttachmentPath	string	File name and extension assigned on upload (with timestamp suffix).
AttachmentType	string	Type of document (e.g., Insurance Certificate, Vehicle Image).
AttachmentSize	integer	Size of the file in bytes.
UploadedAt	string	UTC timestamp when the file was uploaded.
ParentId	string	Identifier of the parent entity (`trailerId`).
ParentType	string	Entity type the document is attached to (`Trailer`).
UploadedBy	string	User ID if uploaded via UI, or Client ID if uploaded via API.
DownloadUrl	string	Time-limited link (10 minutes) to download the document.
ExpiresAt	string	Expiration timestamp of the `DownloadUrl`.

Example Response (200 OK)

[
  {
    "id": "ec0a0ef0-000c-0000-9f00-5d0f00c4cf00",
    "AttachmentPath": "TrailerIns-1759237626.pdf",
    "AttachmentType": "Insurance Certificate",
    "AttachmentSize": 95421,
    "UploadedAt": "2025-09-30T17:07:07+00:00",
    "ParentId": "TRL002",
    "ParentType": "Trailer",
    "UploadedBy": "1110002eecc3408e90d3322f4ece0e11",
    "DownloadUrl": "https://alvysqastorage.blob.core.windows.net/tl743/TrailerIns-1759237626.pdf?...",
    "ExpiresAt": "2025-09-30T17:17:15.9506343+00:00"
  }
]

Rate Limits

All endpoints are subject to rate limits to protect the API from traffic spikes. For detailed information, see the Rate Limits section.

Try It Out

This page is interactive, allowing you to try a request by specifying the API version and trailerId in the URL path. As you fill out the parameters, the cURL command on the right side of the page will be automatically updated. Alternatively, you can directly edit the cURL command. ⚠️ Don’t forget: make sure to authorize yourself before trying a request.

Authorizations

Authorization

string

header

required

OAuth 2.0 client-credentials access token. Obtain one from https://auth.alvys.com/oauth/token (grant_type=client_credentials, audience=https://api.alvys.com/public/), then paste it here. The playground sends it as Authorization: Bearer <token>.

Path Parameters

trailerId

string

required

version

string

default:1.0

required

API version (e.g., 1.0)

Example:

"1.0"

Response

string

required

AttachmentPath

string

required

AttachmentType

string

required

ParentId

string

required

ParentType

string

required

AttachmentSize

integer<int64> | null

UploadedAt

string<date-time> | null

UploadedBy

string | null

DownloadUrl

string | null

ExpiresAt

string<date-time> | null

⌘I

List trailer documents

curl --request GET \
  --url https://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents",
  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: Bearer <token>"
  ],
]);

$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://integrations.alvys.com/api/p/v{version}/trailers/{trailerId}/documents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

[
  {
    "id": "<string>",
    "AttachmentPath": "<string>",
    "AttachmentType": "<string>",
    "ParentId": "<string>",
    "ParentType": "<string>",
    "AttachmentSize": 123,
    "UploadedAt": "2023-11-07T05:31:56Z",
    "UploadedBy": "<string>",
    "DownloadUrl": "<string>",
    "ExpiresAt": "2023-11-07T05:31:56Z"
  }
]

{
  "Errors": {},
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

​Request Parameters

​Example cURL Request

​Response Body

​Example Response (200 OK)

​Rate Limits

​Try It Out

Authorizations

Path Parameters

Response

Request Parameters

Example cURL Request

Response Body

Example Response (200 OK)

Rate Limits

Try It Out