Skip to main content

​
Retrieve a Policy Version

Returns the full details of a specific version of a policy, including the recipe that was active at that version. 
GET /v1/docks/:dockId/policies/:policyId/versions/:version

​
Path Parameters

ParameterTypeDescription
dockIdstringThe dock ID
policyIdstringThe policy ID
versionintegerThe version number

​
Example Request

curl https://api.docyard.io/v1/docks/dock_01HQ3K.../policies/pol_01HQ3P.../versions/2 \
  -H "Authorization: Bearer dk_live_a1b2c3d4..."

​
Response

{
  "version": 2,
  "policyId": "pol_01HQ3P...",
  "recipe": {
    "access": "read",
    "artifactTypes": ["declaration-page", "coi"],
    "requireFactors": ["email_verified"],
    "expiresInDays": 90
  },
  "changelog": "Initial production release",
  "createdAt": "2025-01-18T14:00:00.000Z"
}

​
Error Handling

StatusCondition
401Missing or invalid API key
404Policy, dock, or version not found