Reserve an available DID before ordering it.

POST

https://api.veloconnect.me/api/did/reservations

Telephony

Last modified:2026-06-01 19:28:25

Example request:

POST /api/did/reservations
{
"availableDidId": "available_did_123456",
"description": "Temporary reservation for checkout"
}

Authentication: Requires JWT bearer token.

Request body: DidReservationsRequestDto

Success response (200): SuccessResponseModelOfDidReservationDto

Request

Authorization

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Bodyapplication/json

🟠400Bad Request

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

cURLHttpiewget

curl --location 'https://api.veloconnect.me/api/did/reservations' \
--header 'Content-Type: application/json' \
--data '{
    "availableDidId": "available_did_123456",
    "description": "Temporary reservation for onboarding flow"
}'

Response Example

200 - Success Example

{
    "data": [
        {
            "id": "string",
            "availableDidId": "string",
            "description": "string",
            "expiresAtUtc": "2025-01-01T00:00:00Z"
        }
    ]
}

Modified at 2026-06-01 19:28:25

Cancel a DID order.

List DID reservations, optionally filtered by reservation id or available DID id.