> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dekasign.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Read visited approval history

> Returns the request status, revision, visited steps and remaining-layer estimate without form values. Current app, requester and request-scope authorization still applies.



## OpenAPI

````yaml /openapi.json get /api/v1/approval-requests/{id}/history
openapi: 3.0.3
info:
  title: DekaSign integration and session API
  version: '2026-10-28'
  description: >-
    Production APIs require an active paid plan, Production app/key, allowed
    scopes and enabled capabilities. Some design-management operations remain
    sandbox-only. Template authoring and human approval decisions are not
    delegated to API keys. Session routes use separate identity. This
    specification grants no access or capability activation.
servers:
  - url: https://{workspace}.dekasign.com
    description: Use the organization workspace authorized for your integration app.
    variables:
      workspace:
        default: your-workspace
security: []
paths:
  /api/v1/approval-requests/{id}/history:
    get:
      tags:
        - approval-requests
      summary: Read visited approval history
      description: >-
        Returns the request status, revision, visited steps and remaining-layer
        estimate without form values. Current app, requester and request-scope
        authorization still applies.
      operationId: get_approval_requests_id_history
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 150
          description: Workspace-scoped identifier.
        - name: X-Dekasign-Environment
          in: header
          required: true
          schema:
            type: string
            enum:
              - sandbox
              - production
      responses:
        '200':
          description: Current authorized result.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  environment:
                    type: string
                    enum:
                      - sandbox
                      - production
                  approval_status:
                    type: string
                  request_revision:
                    type: integer
                  visited_approval_steps:
                    type: array
                    items:
                      type: object
                      properties:
                        node_id:
                          type: string
                        request_revision:
                          type: integer
                        status:
                          type: string
                        opened_at:
                          type: string
                          format: date-time
                        closed_at:
                          type: string
                          format: date-time
                          nullable: true
                        sla_due_at:
                          type: string
                          format: date-time
                          nullable: true
                        decisions:
                          type: array
                          items:
                            type: object
                            properties:
                              action:
                                type: string
                              comment:
                                type: string
                                nullable: true
                              actor_name:
                                type: string
                              decided_at:
                                type: string
                                format: date-time
                            required:
                              - action
                              - comment
                              - actor_name
                              - decided_at
                            additionalProperties: false
                      required:
                        - node_id
                        - request_revision
                        - status
                        - opened_at
                        - closed_at
                        - sla_due_at
                        - decisions
                      additionalProperties: false
                  remaining_approval_layers:
                    type: object
                    properties:
                      count:
                        type: integer
                        minimum: 0
                      known:
                        type: boolean
                    required:
                      - count
                      - known
                    additionalProperties: false
                    nullable: true
                required:
                  - id
                  - environment
                  - approval_status
                  - request_revision
                  - visited_approval_steps
                  - remaining_approval_layers
                additionalProperties: false
        '400':
          description: Invalid operation or layout.
        '401':
          description: Invalid or expired credential/session.
        '403':
          description: Scope, environment, tenant or authority denied.
        '404':
          description: Not found or outside app scope.
        '409':
          description: >-
            Result not ready, integrity failure, changed version, or unavailable
            data-source configuration.
        '422':
          description: Invalid schema or required idempotency key.
        '429':
          description: Rate limited.
        '503':
          description: Environment capability disabled or service temporarily unavailable.
      security:
        - SandboxBearer: []
        - ProductionBearer: []
components:
  securitySchemes:
    SandboxBearer:
      type: http
      scheme: bearer
      description: Sandbox dks_test_ key, server-side only.
    ProductionBearer:
      type: http
      scheme: bearer
      description: Production dks_live_ key, server-side only.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.