--- title: "Get document group info (v.2)" url: "https://docs.signnow.com/docs/document-group/operations/get-document-group-info-v2" type: "endpoint" section: "document-group" slug: "document-group/operations/get-document-group-info-v2" method: "GET" path: "/v2/document-groups/{document_group_id}" operation_id: "get-document-group-info-v2" authorization: "bearer" --- # Get document group info (v.2) `GET /v2/document-groups/{document_group_id}` This endpoint allows API users to retrieve detailed information about a specific document group, including its documents, assigned roles, field and FreeForm invites, share info, owner details, and originator organization settings. Available to the document group owner and to any user invited on any step, regardless of the current invite or step status. ## Authorization bearer ## Path Parameters | Name | Type | Required | Description | |------|------|----------|-------------| | `document_group_id` | string | Yes | ID of the document group. | ## Query Parameters | Name | Type | Required | Description | |------|------|----------|-------------| | `include=document_group_attributes` | string | No | If used, the response will contain document group attributes. | | `include=reminder` | string | No | If used, the response includes `general_expiration_time`, `general_expiration_days`, and `general_reminder` — defaults applied to all recipients in the invite. | ## Responses ### 200 - Request with correct token - Request with email group - Request with FreeForm invite **Example** (`Example 1`) ```json { "data": { "id": "b8002b2cdbb34b0195415b69e903be6daf6931b8", "name": "Test Document group 1673439682", "owner": { "id": "34d03c52ebcd4157a28eed0c750ed59aed9c0e65", "email": "owner@email.com", "organization": { "id": "37dfe4bf310affafa9ce60591b1019e20f27a63b" } }, "state": "pending", "created": 1673439682, "cc_emails": [ "signer1@email.com", "signer2@email.com" ], "documents": [], "folder_id": null, "invite_id": "7f1f0e1aac0d4b27a6f47228c28c0eec8c02f738", "owner_email": "owner@email.com", "last_invite_id": "7f1f0e1aac0d4b27a6f47228c28c0eec8c02f738", "freeform_invite": { "id": null, "last_id": null }, "pending_step_id": "zzzz2626fabd4319a4eb321e904c8f4272876d88", "general_reminder": { "remind_after": 3, "remind_before": 5, "remind_repeat": 7 }, "general_expiration_days": 30, "general_expiration_time": null } } ``` **Example** (`Request with email group`) ```json { "data": { "id": "02XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "name": "Group with email_group invite", "owner": { "id": "f7XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "email": "owner@email.com", "organization": { "id": "e0XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } }, "state": "pending", "created": 1686312228, "updated": 1686312300, "cc_emails": [], "documents": [ { "id": "07XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "owner": { "id": "57XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "email": "owner@email.com" }, "roles": [ "Signer 1" ], "updated": 1777288568, "settings": [], "folder_id": "edXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "thumbnail": { "large": "https://api.signnow.com/document/07XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large", "small": "https://api.signnow.com/document/07XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small", "medium": "https://api.signnow.com/document/07XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium" }, "has_fields": true, "page_count": 1, "document_name": "Sample document", "field_invites": [ { "id": "2bXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "role": "Signer 1", "action": "sign", "status": "pending", "created": 1777288568, "message": "Sample document group needs your signature.", "updated": 1777288568, "language": null, "compliance": { "cfr": null }, "email_group": { "id": "3eXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "name": "Sample group name" }, "signer_email": "signer1@email.com", "signing_order": 1, "email_statuses": [ { "status": "sent", "created_at": 1777288569, "last_reaction_at": 1777288569 }, { "status": "mail_open", "created_at": 1777289723, "last_reaction_at": 1777289723 } ], "short_link_url": null, "signature_type": null, "expiration_days": 30, "expiration_time": 1779880568, "payment_request": null, "is_full_declined": false, "next_reminder_at": null, "sms_sent_statuses": [], "password_protected": "0", "signer_phone_invite": null } ], "allow_to_remove": true, "shared_with_team": null, "origin_document_id": null, "has_unassigned_field": false, "has_credit_card_number": false } ], "folder_id": null, "invite_id": "22XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "share_info": { "role": "owner", "is_team_shared": false, "is_personally_shared_to_others": false }, "owner_email": "owner@email.com", "sender_name": "Sample Sender", "sender_email": "owner@email.com", "mail_provider": null, "last_invite_id": "22XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "sign_as_merged": false, "freeform_invite": { "id": null, "last_id": null, "message": null }, "pending_step_id": "fdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "general_reminder": null, "scheduled_invite": null, "general_expiration_days": null, "general_expiration_time": null, "email_action_on_complete": null, "document_group_attributes": { "from_name": "Sample Sender", "from_email": "owner@email.com" }, "originator_organization_settings": [] } } ``` **Example** (`Request with correct token`) ```json { "data": { "id": "d6XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "name": "Sample document group", "owner": { "id": "57XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "email": "owner@email.com", "organization": { "id": "1eXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } }, "state": "pending", "created": 1774375376, "updated": 1777288567, "cc_emails": [], "documents": [ { "id": "d4XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "owner": { "id": "57XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "email": "owner@email.com" }, "roles": [ "Candidate", "HR manager", "Viewer 2", "Viewer 3" ], "updated": 1777288568, "settings": [], "folder_id": "edXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "thumbnail": { "large": "https://api.signnow.com/document/d4XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large", "small": "https://api.signnow.com/document/d4XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small", "medium": "https://api.signnow.com/document/d4XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium" }, "has_fields": true, "page_count": 1, "document_name": "Offerletter", "field_invites": [ { "id": "c9XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "role": "HR manager", "action": "approve", "status": "pending", "created": 1777288568, "message": "Sample document group needs your signature.", "updated": 1777288568, "language": null, "compliance": { "cfr": null }, "email_group": { "id": null, "name": null }, "signer_email": "signer1@email.com", "signing_order": 1, "email_statuses": [ { "status": "sent", "created_at": 1777288569, "last_reaction_at": 1777288569 }, { "status": "mail_open", "created_at": 1777289723, "last_reaction_at": 1777289723 } ], "short_link_url": null, "signature_type": null, "expiration_days": 30, "expiration_time": 1779880568, "payment_request": null, "is_full_declined": false, "next_reminder_at": null, "sms_sent_statuses": [], "password_protected": "0", "signer_phone_invite": null }, { "id": "5aXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "role": "Candidate", "action": "sign", "status": "created", "created": 1777288568, "message": "Sample document group needs your signature.", "updated": 1777288568, "language": null, "compliance": { "cfr": null }, "email_group": { "id": null, "name": null }, "signer_email": "signer2@email.com", "signing_order": 2, "email_statuses": [], "short_link_url": null, "signature_type": null, "expiration_days": 30, "expiration_time": null, "payment_request": null, "is_full_declined": false, "next_reminder_at": null, "sms_sent_statuses": [], "password_protected": "0", "signer_phone_invite": null }, { "id": "54XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "role": "Viewer 2", "action": "view", "status": "created", "created": 1777288568, "message": "Sample document group needs your signature.", "updated": 1777288568, "language": null, "compliance": { "cfr": null }, "email_group": { "id": null, "name": null }, "signer_email": "signer3@email.com", "signing_order": 3, "email_statuses": [], "short_link_url": null, "signature_type": null, "expiration_days": 30, "expiration_time": null, "payment_request": null, "is_full_declined": false, "next_reminder_at": null, "sms_sent_statuses": [], "password_protected": "0", "signer_phone_invite": null }, { "id": "f7XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "role": "Viewer 3", "action": "view", "status": "created", "created": 1777288568, "message": "Sample document group needs your signature.", "updated": 1777288568, "language": null, "compliance": { "cfr": null }, "email_group": { "id": null, "name": null }, "signer_email": "signer4@email.com", "signing_order": 4, "email_statuses": [], "short_link_url": null, "signature_type": null, "expiration_days": 30, "expiration_time": null, "payment_request": null, "is_full_declined": false, "next_reminder_at": null, "sms_sent_statuses": [], "password_protected": "0", "signer_phone_invite": null } ], "allow_to_remove": true, "shared_with_team": null, "origin_document_id": "7cXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "has_unassigned_field": false, "has_credit_card_number": false }, { "id": "d6XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "owner": { "id": "57XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "email": "owner@email.com" }, "roles": [ "CEO", "Employee", "HR manager", "Viewer 1" ], "updated": 1777288568, "settings": [], "folder_id": "edXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "thumbnail": { "large": "https://api.signnow.com/document/d6XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large", "small": "https://api.signnow.com/document/d6XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small", "medium": "https://api.signnow.com/document/d6XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium" }, "has_fields": true, "page_count": 1, "document_name": "EMPLOYMENTCONTRACT", "field_invites": [ { "id": "fbXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "role": "HR manager", "action": "approve", "status": "pending", "created": 1777288568, "message": "Sample document group needs your signature.", "updated": 1777288568, "language": null, "compliance": { "cfr": null }, "email_group": { "id": null, "name": null }, "signer_email": "signer1@email.com", "signing_order": 1, "email_statuses": [ { "status": "sent", "created_at": 1777288569, "last_reaction_at": 1777288569 }, { "status": "mail_open", "created_at": 1777289723, "last_reaction_at": 1777289723 } ], "short_link_url": null, "signature_type": null, "expiration_days": 30, "expiration_time": 1779880568, "payment_request": null, "is_full_declined": false, "next_reminder_at": null, "sms_sent_statuses": [], "password_protected": "0", "signer_phone_invite": null }, { "id": "20XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "role": "Viewer 1", "action": "view", "status": "created", "created": 1777288568, "message": "Sample document group needs your signature.", "updated": 1777288568, "language": null, "compliance": { "cfr": null }, "email_group": { "id": null, "name": null }, "signer_email": "signer3@email.com", "signing_order": 2, "email_statuses": [], "short_link_url": null, "signature_type": null, "expiration_days": 30, "expiration_time": null, "payment_request": null, "is_full_declined": false, "next_reminder_at": null, "sms_sent_statuses": [], "password_protected": "0", "signer_phone_invite": null }, { "id": "7dXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "role": "CEO", "action": "sign", "status": "created", "created": 1777288568, "message": "Sample document group needs your signature.", "updated": 1777288568, "language": null, "compliance": { "cfr": null }, "email_group": { "id": null, "name": null }, "signer_email": "signer2@email.com", "signing_order": 3, "email_statuses": [], "short_link_url": null, "signature_type": null, "expiration_days": 30, "expiration_time": null, "payment_request": null, "is_full_declined": false, "next_reminder_at": null, "sms_sent_statuses": [], "password_protected": "0", "signer_phone_invite": null }, { "id": "14XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "role": "Employee", "action": "sign", "status": "created", "created": 1777288568, "message": "Sample document group needs your signature.", "updated": 1777288568, "language": null, "compliance": { "cfr": null }, "email_group": { "id": null, "name": null }, "signer_email": "signer4@email.com", "signing_order": 4, "email_statuses": [], "short_link_url": null, "signature_type": null, "expiration_days": 30, "expiration_time": null, "payment_request": null, "is_full_declined": false, "next_reminder_at": null, "sms_sent_statuses": [], "password_protected": "0", "signer_phone_invite": null } ], "allow_to_remove": true, "shared_with_team": null, "origin_document_id": "2dXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "has_unassigned_field": false, "has_credit_card_number": false } ], "folder_id": "edXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "invite_id": "c3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "share_info": { "role": "owner", "is_team_shared": false, "is_personally_shared_to_others": false }, "owner_email": "owner@email.com", "sender_name": "Sample Sender", "sender_email": "owner@email.com", "mail_provider": null, "last_invite_id": "c3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "sign_as_merged": true, "freeform_invite": { "id": null, "last_id": null, "message": null }, "pending_step_id": "acXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "general_reminder": { "remind_after": 3, "remind_before": 5, "remind_repeat": 7 }, "scheduled_invite": null, "general_expiration_days": 30, "general_expiration_time": null, "email_action_on_complete": null, "document_group_attributes": { "from_name": "Sample Sender", "from_email": "owner@email.com" }, "originator_organization_settings": [ { "value": "no", "setting": "digitally_sign_dowloaded_docs" }, { "value": "no", "setting": "electronic_consent_required" }, { "value": "0", "setting": "require_email_subject" }, { "value": "0", "setting": "require_authentication_for_invites" }, { "value": "https://www.signnow.com/", "setting": "invite_canceled_redirect_url" }, { "value": "https://app.signnow.com/webapp/", "setting": "invite_completion_redirect_url" }, { "value": "https://app.signnow.com/webapp/", "setting": "invite_decline_redirect_url" }, { "value": "https://app.signnow.com/webapp/", "setting": "save_draft_redirect_url" }, { "value": "0", "setting": "disable_branding_setup" }, { "value": "1", "setting": "guide_signers_only_through_required_fields" }, { "value": "1", "setting": "document_guide" }, { "value": "0", "setting": "required_preset_signature_name" }, { "value": "0", "setting": "require_login_for_signing" }, { "value": "0", "setting": "logout_on_signing" }, { "value": "0", "setting": "front_end_session_length" }, { "value": "0", "setting": "add_signature_stamp_with_name" }, { "value": "0", "setting": "cfr_title_21_part_11" }, { "value": "0", "setting": "no_user_signature_return" }, { "value": "0", "setting": "disable_email_notifications" }, { "value": "no", "setting": "block_login_via_social_networks" }, { "value": "0", "setting": "hide_upgrade_subscription_button" }, { "value": "0", "setting": "hide_decline_to_sign_option_in_signing_session" }, { "value": "1", "setting": "common_experiments" }, { "value": "0", "setting": "have_merged_document_group_option" }, { "value": "0", "setting": "allow_download_certificate" }, { "value": "30", "setting": "invite_expiration_days" }, { "value": "0", "setting": "allow_big_count_of_attachment_fields_per_document" }, { "value": "0", "setting": "allow_big_attachment_file" }, { "value": "0", "setting": "enable_hyperlink_field" }, { "value": "0", "setting": "disable_download_action_in_editor" }, { "value": "bottom", "setting": "signature_stamp_position" }, { "value": "1", "setting": "save_signer_signature_and_initials" }, { "value": "1", "setting": "auto_apply_signatures_and_initials_to_document_fields" }, { "value": "0", "setting": "receive_signer_email_after_sent_field_invite_to_yourself" }, { "value": "0", "setting": "allow_edit_document_after_signing" }, { "value": "0", "setting": "enable_render_pages_in_editor_as_images" }, { "value": "off", "setting": "every_signature_and_initials_field_requires_user_authentication" }, { "value": "0", "setting": "enable_team_admin_move_docs" }, { "value": "0", "setting": "allow_team_admin_rename_docs" }, { "value": "0", "setting": "disable_email_recipients" }, { "value": "0", "setting": "allow_qes" }, { "value": "0", "setting": "enable_qes" }, { "value": "0", "setting": "add_signers_name_to_document_history_header" } ] } } ``` **Example** (`Request with freeform invite`) ```json { "data": { "id": "12XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "name": "Sample document group with freeform invite", "owner": { "id": "f7XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "email": "owner@email.com", "organization": { "id": "e0XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } }, "state": "pending", "created": 1686312228, "updated": 1686312300, "cc_emails": [], "documents": [ { "id": "07XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "owner": { "id": "f7XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "email": "owner@email.com" }, "roles": [ "Signer 1" ], "updated": 1686312233, "settings": [], "folder_id": null, "thumbnail": { "large": "https://api.signnow.com/document/07XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large", "small": "https://api.signnow.com/document/07XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small", "medium": "https://api.signnow.com/document/07XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium" }, "has_fields": false, "page_count": 1, "document_name": "Sample document", "field_invites": [], "allow_to_remove": true, "freeform_invites": [ { "id": "ffXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "status": "pending", "created": 1686312233, "updated": 1686312233, "signer_email": "signer@email.com", "email_statuses": [ { "status": "sent", "created_at": 1686312234, "last_reaction_at": 1686312234 }, { "status": "mail_open", "created_at": 1686398634, "last_reaction_at": 1686398634 } ] } ], "shared_with_team": null, "origin_document_id": null, "has_unassigned_field": false, "has_credit_card_number": false } ], "folder_id": null, "invite_id": "22XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "share_info": { "role": "owner", "is_team_shared": false, "is_personally_shared_to_others": false }, "owner_email": "owner@email.com", "sender_name": "Sample Sender", "sender_email": "owner@email.com", "mail_provider": null, "last_invite_id": "22XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "sign_as_merged": false, "freeform_invite": { "id": "22XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "last_id": "22XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "message": null }, "pending_step_id": null, "general_reminder": null, "scheduled_invite": null, "general_expiration_days": null, "general_expiration_time": null, "email_action_on_complete": null, "document_group_attributes": { "from_name": "Sample Sender", "from_email": "owner@email.com" }, "originator_organization_settings": [] } } ``` ### 400 - Request with Incorrect or missing token **Example** (`Example 1`) ```json { "code": 1537, "error": "invalid_token" } ``` **Example** (`Request with Incorrect or missing token`) ```json { "code": 1537, "error": "invalid_token" } ``` ### 403 - Request with token that belongs to the user, who is not a document group owner and was not invited to the group **Example** (`Example 1`) ```json { "errors": [ { "code": 0, "message": "Access to DocumentGroup denied" } ] } ``` **Example** (`Request with token that belongs to the user, who is not a document group owner and was not invited to the group`) ```json { "errors": [ { "code": 0, "message": "Access to DocumentGroup denied" } ] } ``` ### 404 - id does not exist - id is not active **Example** (`Example 1`) ```json { "errors": [ { "message": "Document group `` not found" } ] } ``` **Example** (`id is not active`) ```json { "errors": [ { "message": "Document group `` not found" } ] } ``` **Example** (`id does not exist`) ```json { "errors": [ { "message": "Document group `` not found" } ] } ``` ## Code Examples > Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running. ### cURL ```bash curl -X GET \ "https://api.signnow.com/v2/document-groups/{document_group_id}" \ -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN" ``` --- *Full reference: https://docs.signnow.com/docs/document-group/operations/get-document-group-info-v2*