--- title: "Get logs" url: "https://docs.signnow.com/docs/api-logs/operations/get-request-logs" type: "endpoint" section: "api-logs" slug: "api-logs/operations/get-request-logs" method: "GET" path: "/request-logs" operation_id: "get-request-logs" authorization: "bearer" --- # Get logs `GET /request-logs` This endpoint allows API users to retrieve request logs for all of the user's active applications. ## Authorization bearer ## Query Parameters | Name | Type | Required | Description | |------|------|----------|-------------| | `per_page` | string | No | Allowed values: any positive integer starting from 1. | | `page` | string | No | Allowed values: any positive integer starting from 1. | | `filter:error` | string | No | Possible values: true/false. Format: `?filters=[{"error":{"type": "=", "value":true}}]`` | | `filter:applicationId` | string | No | Possible values: one or several strings in array. Format: `?filters=[{"applicationId":{"type": "in", "value":["e1656509199c931911e919a00b1906ad1a26a450", "e1656509199c931911e919a00b1906ad1a26a451"]}}]` | | `filter:method` | string | No | Possible values: array of strings. Format: `?filters=[{"method":{"type": "in", "value": "POST", "PUT]}}]` | | `filter:uri` | string | No | Possible values: array of strings. Format: `?filters=[{"uri":{"type": "match", "value": "string"}}]` - finds only requests where the uri contains the value of the filter; `?filters=[{"uri":{"type": "like", "value": "user"}}]` - finds requests where the uri contains text from values of the filter. | | `filter:code` | string | No | Possible values: array of two integers. Format: `?filters=[{"code":{"type": "between", "value": [0,500]}}]` | | `filter:time` | string | No | Possible values: integer. Format: `?filters=[{"time":{"type": "=", "value": 2}}]` | | `filter:created` | string | No | Possible values: two integers in array. Format: `?filters=[{"created":{"type": "between", "value": [1565360895, 1565360896]}}]` | | `sort:created` | string | No | Sort results in ascending or descending order. Possible values: asc/desc. Format: `?sort[email]=asc` | ## Responses ### 200 Successful response. Returns the request logs. **Example** (`Successful response`) ```json { "data": [ { "error": false, "created": 1790686076.865, "request": { "ip": "104.30.XX.XX", "uri": "/oauth2/token", "body": "{\"grant_type\":\"password\",\"password\":\"*****\",\"scope\":\"*\",\"username\":\"*****\"}", "host": "api.signnow.com", "query": "{}", "method": "POST", "source": "PostmanRuntime/2.8.0", "headers": "{\"authorization\":\"*****\",\"user-agent\":\"PostmanRuntime/2.8.0\"}" }, "user_id": "", "response": { "body": "{\"access_token\":\"*****\",\"expires_in\":2592000,\"last_login\":1,\"refresh_token\":\"*****\",\"scope\":\"*\",\"token_type\":\"bearer\"}", "code": 200, "time": "0.563", "headers": "{\"access-control-allow-headers\":\"Authorization\",\"access-control-allow-origin\":\"*\",\"cache-control\":\"no-cache, private\",\"connection\":\"close\",\"content-type\":\"application/json; charset=utf-8\",\"strict-transport-security\":\"max-age=31536000; includeSubDomains\",\"transfer-encoding\":\"chunked\",\"x-burst-limit\":\"100\",\"x-burst-remaining\":\"99\",\"x-envoy-upstream-service-time\":\"561\",\"x-frame-options\":\"SAMEORIGIN\",\"x-request-id\":\"dc741f66a300eb62b6549713fd55fe42\"}" }, "request_id": "dc741f66a300eb62b6549713fd55fe42", "api_version": "legacy", "application_id": "19afd279a79e69c83f5e7e7276dc081fd3188ef1", "application_name": "HubSpot_app", "application_owner_email": "user1@example.com" }, { "error": false, "created": 1790688365.467, "request": { "ip": "104.30.XX.XX", "uri": "/user/documentgroup/templates", "body": null, "host": "api.signnow.com", "query": "{\"limit\":\"5\"}", "method": "GET", "source": "curl/7.81.0", "headers": "{\"authorization\":\"*****\",\"user-agent\":\"curl/7.81.0\"}" }, "user_id": "3cc0095f2a88e3eee94525e01cea1d1fbd1833ca", "response": { "body": "{\"document_group_template_total_count\":60,\"document_group_templates\":[{\"folder_id\":null,\"is_prepared\":true,\"last_updated\":\"1790588411\",\"own_as_merged\":true,\"owner_email\":\"user1@example.com\",\"template_group_id\":\"7944da508891493ea6d7f8ea73f1e57173fc1218\",\"template_group_name\":\"EmploymentAgreement\",\"templates\":[{\"id\":\"af38758172a0b0506100310eff5026ebea0f5b8d\",\"name\":\"EmploymentAgreement\",\"roles\":[\"Manager\"],\"thumbnail\":{\"large\":\"https://api.signnow.com/document/af38758172a0b0506100310eff5026ebea0f5b8d/thumbnail?size=large\",\"medium\":\"https://api.signnow.com/document/af38758172a0b0506100310eff5026ebea0f5b8d/thumbnail?size=medium\",\"small\":\"https://api.signnow.com/document/af38758172a0b0506100310eff5026ebea0f5b8d/thumbnail?size=small\"}}]},{\"folder_id\":null,\"is_prepared\":false,\"last_updated\":\"1789486292\",\"own_as_merged\":true,\"owner_email\":\"user1@example.com\",\"template_group_id\":\"7ada9238565f56985393f5c58034bc50a21bc69b\",\"template_group_name\":\"DocgenAgreementDemoAug2026\",\"templates\":[{\"id\":\"393fb7916b5ffa329d11f5c434e5d9b484e512a0\",\"name\":\"DocgenAgreementDemoAug2026\",\"roles\":[\"Recipient1\"],\"thumbnail\":{\"large\":\"https://api.signnow.com/document/393fb7916b5ffa329d11f5c434e5d9b484e512a0/thumbnail?size=large\",\"medium\":\"https://api.signnow.com/document/393fb7916b5ffa329d11f5c434e5d9b484e512a0/thumbnail?size=medium\",\"small\":\"https://api.signnow.com/document/393fb7916b5ffa329d11f5c434e5d9b484e512a0/thumbnail?size=small\"}}]},{\"folder_id\":null,\"is_prepared\":true,\"last_updated\":\"1788429634\",\"own_as_merged\":true,\"owner_email\":\"user1@example.com\",\"template_group_id\":\"52732813343be959205438e0d86422e73708b5f1\",\"template_group_name\":\"Subcontract-Agreement-Demo\",\"templates\":[{\"id\":\"06d9e2b1a244510cf82ca3a6976b78ece0b6e821\",\"name\":\"Subcontract-Agreement-Demo\",\"roles\":[\"Contractor\",\"Subcontractor\"],\"thumbnail\":{\"large\":\"https://api.signnow.com/document/06d9e2b1a244510cf82ca3a6976b78ece0b6e821/thumbnail?size=large\",\"medium\":\"https://api.signnow.com/document/06d9e2b1a244510cf82ca3a6976b78ece0b6e821/thumbnail?size=medium\",\"small\":\"https://api.signnow.com/document/06d9e2b1a244510cf82ca3a6976b78ece0b6e821/thumbnail?size=small\"}}]},{\"folder_id\":null,\"is_prepared\":true,\"last_updated\":\"1788428130\",\"own_as_merged\":true,\"owner_email\":\"user1@example.com\",\"template_group_id\":\"eb644ca80954f1f05b6c48484586bbe8deae4303\",\"template_group_name\":\"Subcontract-Agreement-Demo\",\"templates\":[{\"id\":\"7e3fa4858145190e74c18865b6237f2e3995c320\",\"name\":\"Subcontract-Agreement-Demo\",\"roles\":[\"Contractor\",\"Subcontractor\"],\"thumbnail\":{\"large\":\"https://api.signnow.com/document/7e3fa4858145190e74c18865b6237f2e3995c320/thumbnail?size=large\",\"medium\":\"https://api.signnow.com/document/7e3fa4858145190e74c18865b6237f2e3995c320/thumbnail?size=medium\",\"small\":\"https://api.signnow.com/document/7e3fa4858145190e74c18865b6237f2e3995c320/thumbnail?size=small\"}}]},{\"folder_id\":null,\"is_prepared\":false,\"last_updated\":\"1788427220\",\"own_as_merged\":true,\"owner_email\":\"user1@example.com\",\"template_group_id\":\"84869a8cd3455065c8fb80a90be05627f1dc01e5\",\"template_group_name\":\"Subcontract-Agreement-Demo\",\"templates\":[{\"id\":\"dbd3b185a02a5a9f945f443e50d34542edcc6e7e\",\"name\":\"Subcontract-Agreement-Demo\",\"roles\":[],\"thumbnail\":{\"large\":\"https://api.signnow.com/document/dbd3b185a02a5a9f945f443e50d34542edcc6e7e/thumbnail?size=large\",\"medium\":\"https://api.signnow.com/document/dbd3b185a02a5a9f945f443e50d34542edcc6e7e/thumbnail?size=medium\",\"small\":\"https://api.signnow.com/document/dbd3b185a02a5a9f945f443e50d34542edcc6e7e/thumbnail?size=small\"}}]}]}", "code": 200, "time": "0.213", "headers": "{\"cache-control\":\"no-cache, private\",\"connection\":\"close\",\"content-type\":\"application/json\",\"strict-transport-security\":\"max-age=31536000; includeSubDomains\",\"transfer-encoding\":\"chunked\",\"x-envoy-upstream-service-time\":\"126\",\"x-ratelimit-limit\":\"1000\",\"x-ratelimit-remaining\":\"999\",\"x-ratelimit-reset\":\"1790694000\",\"x-request-id\":\"ff8cdac6c108bf892ef2520891c1fcbc\"}" }, "request_id": "ff8cdac6c108bf892ef2520891c1fcbc", "api_version": "legacy", "application_id": "19afd279a79e69c83f5e7e7276dc081fd3188ef1", "application_name": "HubSpot_app", "application_owner_email": "user1@example.com" } ], "meta": { "pagination": { "count": 5, "links": { "next": "https://api.signnow.com/request-logs?page=2" }, "total": 898, "per_page": 5, "total_pages": 180, "current_page": 1 } } } ``` ### 400 Wrong, expired, or missing token. **Example** (`Wrong token`) ```json { "code": 1537, "error": "invalid_token" } ``` ### 403 The user doesn't have an active API subscription. **Example** (`No active subscription`) ```json { "errors": [ { "code": 0, "message": "User does not have active subscription" } ] } ``` ## Code Examples > Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running. ### cURL ```bash curl -X GET \ "https://api.signnow.com/request-logs" \ -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN" ``` --- *Full reference: https://docs.signnow.com/docs/api-logs/operations/get-request-logs*