---
title: "Get modified documents"
method: GET
path: "/user/documentsv2"
---

# Get modified documents

`GET /user/documentsv2`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/user/documentsv2`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/user/documentsv2/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns an array of user's documents that were modified (added fields, texts, signatures, etc.)

> [!WARNING]
> This endpoint is deprecated. To retrieve a user's documents, fetch the contents of a folder with [`GET /folder/{folder_id}`](/docs/folder/operations/get-folder-by-id).

## Response `200`

- object[]
  - `id` string: object ID
  - `tags` object[]
    - `name` string
    - `type` string
  - `owner` string: user who uploaded the document to SignNow
  - `roles` object[]: roles assigned to fields, e.g. Signer 1, Signer 2
    - `name` string
    - `unique_id` string
    - `signing_order` string
  - `seals` object[]: all seals on the document
  - `texts` object[]: all field input, if there are fillable fields and they are completed
  - `checks` object[]: all checkmarks on the document
  - `fields` object[]: all fields on the document
    - `id` string
    - `role` string
    - `type` string
    - `role_id` string
    - `field_id` unknown
    - `fulfiller` unknown
    - `element_id` unknown
    - `originator` string
    - `json_attributes` object
      - `x` integer
      - `y` integer
      - `bold` boolean
      - `font` string
      - `name` string
      - `size` integer
      - `align` string
      - `width` integer
      - `height` integer
      - `italic` boolean
      - `valign` string
      - `required` boolean
      - `max_chars` integer
      - `max_lines` integer
      - `underline` boolean
      - `arrangement` string
      - `page_number` integer
    - `field_request_id` unknown
    - `template_field_id` unknown
    - `field_request_canceled` unknown
  - `created` string: Unix timestamp of when the document was created
  - `inserts` object[]
  - `updated` string: Unix timestamp of when the document was updated
  - `user_id` string: user's ID
  - `requests` object[]: requests with this document
  - `settings` object: user's settings applied
    - `copy_export` boolean
    - `upload_limit` boolean
    - `document_guide` boolean
    - `sso-only-login` boolean
    - `mobileweb_option` boolean
    - `cloud_auto_export` boolean
    - `logout_on_signing` boolean
    - `restrict_download` boolean
    - `add_signature_stamp` boolean
    - `cfr_title_21_part_11` boolean
    - `require_email_subject` boolean
    - `no_document_attachment` boolean
    - `electronic_consent_text` boolean
    - `org_allowed_team_admins` boolean
    - `document_schema_extended` boolean
    - `front_end_session_length` boolean
    - `no_user_signature_return` boolean
    - `require_drawn_signatures` boolean
    - `cloud_export_with_history` boolean
    - `enable_full_story_tracker` boolean
    - `require_login_for_signing` boolean
    - `disable_email_notifications` boolean
    - `electronic_consent_required` boolean
    - `email_admin_on_banned_login` boolean
    - `enable_hyperlink_protection` boolean
    - `invite_decline_redirect_url` boolean
    - `emailed_docs_include_history` boolean
    - `no_document_file_attachments` boolean
    - `add_signature_stamp_with_name` boolean
    - `digitally_sign_dowloaded_docs` boolean
    - `watermark_downloaded_document` boolean
    - `invite_completion_redirect_url` boolean
    - `required_preset_signature_name` boolean
    - `signing_link_document_download` boolean
    - `block_login_via_social_networks` boolean
    - `enable_advanced_threat_protection` boolean
    - `document_completion_retention_days` boolean
    - `require_authentication_for_invites` boolean
    - `document_attachment_only_for_signer` boolean
    - `unsuccessful_logout_attempts_allowed` boolean
    - `audit_trail_completion_retention_days` boolean
    - `pending_invite_document_view_notification` boolean
    - `only_administrator_is_able_to_invite_to_the_team` boolean
    - `block_export_options_when_credit_card_validation_is_used` boolean
    - `invite_update_notifications_for_all_invites_at_invite_create` boolean
  - `template` boolean: whether or not this document is a template
  - `thumbnail` object
    - `large` string
    - `small` string
    - `medium` string
  - `hyperlinks` object[]: all hyperlinks in the document
  - `page_count` string: how many pages in the document
  - `signatures` object[]: all signatures on the document
  - `attachments` object[]: all attachments to the document
  - `integrations` object[]
  - `radiobuttons` object[]: all radiobuttons in the document
  - `version_time` string
  - `document_name` string: the name of the document
  - `field_invites` object[]: the invites sent to sign this document
  - `recently_used` string: Timestamp of the last time the document was used.
  - `notary_invites` object[]
  - `origin_user_id` unknown
  - `routing_details` object[]
    - `cc` object[]
    - `id` string
    - `data` object[]
      - `name` string
      - `role_id` string
      - `inviter_role` boolean
      - `default_email` string
      - `signing_order` integer
    - `cc_step` object[]
    - `created` string
    - `updated` unknown
    - `invite_link_instructions` unknown
  - `original_filename` string
  - `origin_document_id` unknown
  - `document_group_info` object: whether or not this document is part of a Document group
    - `invite_id` unknown
    - `invite_status` unknown
    - `document_group_id` unknown
    - `doc_count_in_group` integer
    - `document_group_name` unknown
  - `enumeration_options` object[]: if there is a Dropdown field on the document, these are the options to choose from
  - `document_group_template_info` object[]: whether or not this document is a part of a Document group template
  - `originator_organization_settings` object[]
    - `value` string
    - `setting` string

## Other responses

- `400`: * Request without documents. * Request with query param `per_page=0` or `page=0`. * Request with query param `per_page/page` as string or negative number. * Request with query param `per_page` more than 100.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)
