Get Checkout Session - DHMAD API Documentation

curl -X GET https://dhmad.tn/api/v1/sessions/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer sk_live_your_api_key_here"

const response = await fetch('https://dhmad.tn/api/v1/sessions/550e8400-e29b-41d4-a716-446655440000', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_live_your_api_key_here'
  }
});

const data = await response.json();

import requests

response = requests.get(
    'https://dhmad.tn/api/v1/sessions/550e8400-e29b-41d4-a716-446655440000',
    headers={'Authorization': 'Bearer sk_live_your_api_key_here'}
)

data = response.json()

{
  "session": {
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "escrowId": "507f1f77bcf86cd799439011",
    "action": "sign_contract",
    "targetUserEmail": "buyer@example.com",
    "status": "completed",
    "metadata": {
      "order_id": "ord_123"
    },
    "expiresAt": "2024-01-15T10:30:00Z",
    "completedAt": "2024-01-15T10:15:00Z",
    "createdAt": "2024-01-15T10:00:00Z"
  }
}

Retrieve the current status and details of a checkout session. Use this endpoint to verify whether a session was completed after the user is redirected back to your application. Only sessions belonging to your developer account can be accessed.

curl -X GET https://dhmad.tn/api/v1/sessions/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer sk_live_your_api_key_here"

const response = await fetch('https://dhmad.tn/api/v1/sessions/550e8400-e29b-41d4-a716-446655440000', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_live_your_api_key_here'
  }
});

const data = await response.json();

import requests

response = requests.get(
    'https://dhmad.tn/api/v1/sessions/550e8400-e29b-41d4-a716-446655440000',
    headers={'Authorization': 'Bearer sk_live_your_api_key_here'}
)

data = response.json()

{
  "session": {
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "escrowId": "507f1f77bcf86cd799439011",
    "action": "sign_contract",
    "targetUserEmail": "buyer@example.com",
    "status": "completed",
    "metadata": {
      "order_id": "ord_123"
    },
    "expiresAt": "2024-01-15T10:30:00Z",
    "completedAt": "2024-01-15T10:15:00Z",
    "createdAt": "2024-01-15T10:00:00Z"
  }
}

Path Parameters

string

required

Session ID returned from the create checkout session endpoint

Response Fields

Error Responses

401 Unauthorized

{
  "error": "Unauthorized"
}

403 Forbidden

{
  "error": "Forbidden",
  "message": "You do not have access to this checkout session."
}

404 Not Found

{
  "error": "Checkout session not found"
}

Use this endpoint to verify session status after the user is redirected back to your application. If the redirect includes status=completed, you can call this endpoint to confirm and retrieve full session details. Treat webhooks as the source of truth for escrow state; this endpoint is for session-level verification.