Problem Details

Public API Problems

Every external API error response uses application/problem+json. The type URL in each payload resolves to one of the entries below.

Problems 11
One problem type per error contract.
Bad request 400 · BAD_REQUEST

The request could not be parsed or did not match the expected HTTP shape.

Example detail: Malformed request.

https://api.main.paydia.nl/documentation/v1/problems#problem-bad-request

Unauthenticated 401 · UNAUTHENTICATED

Authentication failed because the API key was missing or invalid.

Example detail: Authentication failed.

https://api.main.paydia.nl/documentation/v1/problems#problem-unauthenticated

Forbidden 403 · FORBIDDEN

The caller is authenticated but not allowed to perform the action.

Example detail: You are not allowed to perform this action.

https://api.main.paydia.nl/documentation/v1/problems#problem-forbidden

Not found 404 · NOT_FOUND

The requested resource, or a referenced upstream resource, could not be found.

Example detail: The requested resource could not be found.

https://api.main.paydia.nl/documentation/v1/problems#problem-not-found

Method not allowed 405 · METHOD_NOT_ALLOWED

The route exists, but the requested HTTP method is not supported.

Example detail: The requested HTTP method is not allowed for this endpoint.

https://api.main.paydia.nl/documentation/v1/problems#problem-method-not-allowed

Conflict 409 · CONFLICT

The requested create operation conflicts with existing resource state.

Example detail: The requested operation conflicts with the current resource state.

https://api.main.paydia.nl/documentation/v1/problems#problem-conflict

Unsupported media type 415 · UNSUPPORTED_MEDIA_TYPE

The request body was sent with an unsupported Content-Type.

Example detail: Content-Type must be application/json.

https://api.main.paydia.nl/documentation/v1/problems#problem-unsupported-media-type

Validation error 422 · VALIDATION_ERROR

The JSON payload was accepted, but one or more fields failed validation.

Example detail: Some fields are invalid.

https://api.main.paydia.nl/documentation/v1/problems#problem-validation-error

Too many requests 429 · TOO_MANY_REQUESTS

The API key exceeded the allowed request rate.

Example detail: Rate limit exceeded.

https://api.main.paydia.nl/documentation/v1/problems#problem-too-many-requests

Service unavailable 503 · SERVICE_UNAVAILABLE

The API is temporarily unavailable.

Example detail: Service temporarily unavailable.

https://api.main.paydia.nl/documentation/v1/problems#problem-service-unavailable

Internal error 500 · INTERNAL_ERROR

An unexpected server-side failure occurred.

Example detail: An unexpected error occurred, please contact support.

https://api.main.paydia.nl/documentation/v1/problems#problem-internal-error

Problem Details Shape

{
    "type": "https://api.main.paydia.nl/documentation/v1/problems#problem-validation-error",
    "title": "Validation error",
    "status": 422,
    "detail": "Some fields are invalid.",
    "instance": "/v1/companies",
    "code": "VALIDATION_ERROR",
    "correlation_id": "01KKEQY1QK81X1R9M9X4H9DZ3W",
    "timestamp": "2026-03-11T00:00:00.000Z",
    "errors": [
        {
            "field": "national_trade_id",
            "message": "The national_trade_id field is required."
        }
    ]
}