Data download endpoint for outbound files
Download a file from Integration Hub. This endpoint allows you to retrieve files that have been created by Adra.
Response Format
- Returns file as binary stream
- Content-Type matches the original file format
- Headers include:
Content-Length
: File size in bytesContent-Type
: File MIME typeLast-Modified
: Timestamp of last modificationETag
: File version identifier
Common Use Cases
- Downloading created reports
- Retrieving journal entries
Error Handling
- 404: File not found or deleted
- 403: Insufficient permissions
- 401: Invalid or expired token
Best Practices
- Cache files using ETag header
- Implement retry logic with exponential backoff
- Handle large files with streaming
Headers
-
Optional HTTP header to optimize request routing and reduce latency. Possible values: EUWE-01 (West Europe), AUEA-01 (Australia East), USEA-01 (East US), NO01 (Norway East).
-
Browser cache instruction (optional)
-
Browser cache instruction (optional).
-
Browser cache instruction (optional).
-
Browser cache instruction (optional).
Path parameters
-
Short identifier for engagement (as in URLs)
-
Value is
MatcherReport
. -
The name of the file
Responses
-
Success
-
Not modified
-
Bad Request: see problem details for more information
-
Unauthorized: Missing an authorization header or token, or the token has expired
-
Forbidden: You don't have access to the engagement, the engagement doesn't have IH or you don't have IH access on the engagement, or the client is trying to access an unauthorized tenant resource
-
Not found
-
Precondition Failed: Access control list (ACL) validation failed
-
Internal Server Error
-
Error
curl \
--request GET 'https://integrationhub.adra.com/api/v3.0/{engagementSid}/files/{outboundFileCategory}/{uniqueFileName}' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "x-gw-stloc-hint: string" \
--header "If-Modified-Since: 2025-05-04T09:42:00Z" \
--header "If-None-Match: string" \
--header "If-Unmodified-Since: 2025-05-04T09:42:00Z" \
--header "If-Match: string"
# Headers
ETag: string
Last-Modified: 2025-05-04T09:42:00Z
# Payload
@file
{
"type": "string",
"title": "string",
"status": 42,
"detail": "string",
"instance": "string"
}
{
"type": "string",
"title": "string",
"status": 42,
"detail": "string",
"instance": "string"
}
{
"type": "https://adra.com/errors/forbidden",
"title": "Forbidden",
"detail": "You don't have access to the engagement, the engagement doesn't have IH or you don't have IH access on the engagement",
"status": 403
}
{
"type": "https://adra.com/errors/forbidden",
"title": "Forbidden",
"detail": "The client is trying to access an unauthorized tenant resource",
"status": 403
}
{
"type": "string",
"title": "string",
"status": 42,
"detail": "string",
"instance": "string"
}
{
"type": "string",
"title": "string",
"status": 42,
"detail": "string",
"instance": "string"
}
{
"type": "string",
"title": "string",
"status": 42,
"detail": "string",
"instance": "string"
}
{
"type": "string",
"title": "string",
"status": 42,
"detail": "string",
"instance": "string"
}