---
title: "List assignments"
method: GET
path: "/v1/assignments"
tags: ["Assignments"]
---

# List assignments

`GET /v1/assignments`

List the assignments belonging to the authenticated user's current account.

[Copy as Markdown](https://api.assinafy.com.br/v1/docs/markdown?method=get&path=%2Fv1%2Fassignments) [Open in ChatGPT](https://chatgpt.com/?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Fassignments%20and%20help%20me%20integrate%20this%20endpoint.) [Open in Claude](https://claude.ai/new?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Fassignments%20and%20help%20me%20integrate%20this%20endpoint.)

## Query parameters

- `page` integer
- `per-page` integer

## Response `200`

A page of assignments

- object — Standard success wrapper. Operations add their own `data`.
  - `status` integer — HTTP status code, mirrored in the body.
  - `message` string — Human-readable message; empty on success.
  - `data` Assignment[]
    - `resource` string
    - `id` string
    - `sender_email` string, email
    - `method` 'virtual' | 'collect'
    - `expires_at` string, date-time, nullable
    - `message` string, nullable
    - `signers` AssignmentSigner[]
      - `resource` string — Present in single-resource responses.
      - `id` string
      - `full_name` string
      - `email` string, email, nullable
      - `whatsapp_phone_number` string, nullable — E.164 format; normalized on save.
      - `has_accepted_terms` boolean
      - `verification_method` string, nullable
      - `notification_methods` string[], nullable
      - `step` integer, nullable — Sequential signing step (defaults to 1).
      - `notified` boolean, nullable
      - `completed` boolean, nullable — Only present in account-owner contexts.
      - `notification_history` NotificationHistoryEntry[], nullable — Per-channel delivery history for this signer (email + WhatsApp), most-recent send order.
        - `event` string
        - `status` 'sent' | 'failed'
        - `error_code` string, nullable
        - `error_message` string, nullable
        - `sent_at` string, date-time, nullable
        - `failed_at` string, date-time, nullable
    - `copy_receivers` object[]
    - `items` AssignmentItem[]
      - `id` string
      - `page` DocumentPage
        - `id` string
        - `number` integer
        - `height` integer
        - `width` integer
        - `download_url` string
      - `signer` object — Signer responsible for this item.
      - `field` object, nullable — Field definition associated with the item.
      - `display_settings` unknown
      - `value` unknown
      - `completed` boolean
    - `summary` AssignmentSummary
      - `signer_count` integer
      - `completed_count` integer
      - `signers` object[]
    - `signing_urls` SigningUrl[]
      - `signer_id` string
      - `url` string

## Other responses

- `401` — Missing or invalid credentials.
- `500` — Unexpected server error.

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) · [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/assinafy/assinafy-api-reference/revisions/f479941d10e9/schema)