Skip to content

Look up a single request log entry by request_id.

GET
/logs/requests/{request_id}
curl --request GET \
--url https://api.swft.co.uk/logs/requests/example \
--header 'Authorization: Bearer <token>'
request_id
required
string

Entry.

Media type application/json
object
id
required
string format: uuid
request_id
required
string
workspace_id
required
string | null format: uuid
api_key_id
required
string | null format: uuid
merchant_id
required
string | null format: uuid
method
required
string
path
required
string
status_code
required
integer
latency_ms
required
integer
request_size_bytes
required
integer | null
response_size_bytes
required
integer | null
user_agent
required
string | null
error_code
required
string | null
created_at
required
string
Example generated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"request_id": "example",
"workspace_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"api_key_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"merchant_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"method": "example",
"path": "example",
"status_code": 1,
"latency_ms": 1,
"request_size_bytes": 1,
"response_size_bytes": 1,
"user_agent": "example",
"error_code": "example",
"created_at": "example"
}

Bad request — malformed input or missing/invalid parameters.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Missing or invalid authentication.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Authenticated but not authorised (e.g. wrong workspace).

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Resource not found.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Conflict — idempotency-key reuse, duplicate resource, etc.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Rate-limited.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}

Internal server error.

Media type application/json
object
error
required
object
type
required
string format: uri
code
required
string
message
required
string
doc_url
required
string format: uri
request_id
required
string
param
string
meta
object
key
additional properties
Example generated
{
"error": {
"type": "https://example.com",
"code": "example",
"message": "example",
"doc_url": "https://example.com",
"request_id": "example",
"param": "example",
"meta": {
"additionalProperty": "example"
}
}
}