{ "variable": [ { "id": "baseUrl", "key": "baseUrl", "type": "string", "name": "string", "value": "https:\/\/postmasterplus.app" } ], "info": { "name": "Postmaster+ API Documentation", "_postman_id": "1d9ffbc2-f8fd-490c-afd6-79b761b8ea91", "description": "", "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json" }, "item": [ { "name": "Domains", "description": "", "item": [ { "name": "Retrieve Domains.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/domains", "query": [ { "key": "page", "value": "1", "description": "The page number. Must be at least 1.", "disabled": false }, { "key": "per_page", "value": "15", "description": "The number of domains per page. Must be at least 1. Must not be greater than 100.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/domains?page=1&per_page=15" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\"success\":true,\"message\":\"Domains retrieved successfully.\",\"data\":[{\"id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"value\":\"example.com\",\"description\":\"Primary sending domain\",\"created_at\":\"2026-03-28T10:30:00.000000Z\",\"updated_at\":\"2026-03-28T10:30:00.000000Z\"}],\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"per_page\":15,\"to\":1,\"total\":1}}", "name": "" } ] }, { "name": "Retrieve Domain Feed.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/domains\/:id\/feed", "query": [ { "key": "page", "value": "1", "description": "The page number for paginated feed results. Must be at least 1.", "disabled": false }, { "key": "date", "value": "2026-04-24", "description": "Filter feed items reported on or after this date, up to today. Must not be older than 90 days from today. Must be a valid date in the format Y-m-d.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/domains\/:id\/feed?page=1&date=2026-04-24", "variable": [ { "id": "id", "key": "id", "value": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "description": "The ULID of the domain." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"Domain feed retrieved successfully.\",\n \"data\": [\n {\n \"reported_at\": \"Mar 28, 2026 5:30PM\",\n \"mail_stream\": \"Transactional Stream\",\n \"domain\": {\n \"id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\n \"value\": \"example.com\",\n \"description\": \"Primary sending domain\",\n \"created_at\": \"2026-03-28T10:30:00.000000Z\",\n \"updated_at\": \"2026-03-28T10:30:00.000000Z\"\n },\n \"spf_domain\": \"example.com\",\n \"seed_message\": {\n \"mail_from_name\": \"Test Sender\",\n \"mail_from\": \"sender@example.com\",\n \"subject\": \"Seed message\",\n \"preview_line\": \"This is a preview.\",\n \"is_compliant\": true,\n \"is_blocklisted\": false,\n \"is_test\": false\n }\n },\n {\n \"message\": \"SPF is valid.\",\n \"reported_at\": \"Mar 28, 2026 4:45PM\",\n \"mail_stream\": \"Transactional Stream\",\n \"domain\": {\n \"id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\n \"value\": \"example.com\",\n \"description\": \"Primary sending domain\",\n \"created_at\": \"2026-03-28T10:30:00.000000Z\",\n \"updated_at\": \"2026-03-28T10:30:00.000000Z\"\n },\n \"spf_domain\": null,\n \"seed_message\": null\n }\n ],\n \"meta\": {\n \"current_page\": 1,\n \"from\": 1,\n \"last_page\": 2,\n \"per_page\": 15,\n \"to\": 15,\n \"total\": 16\n }\n}", "name": "" }, { "header": [], "code": 403, "body": "{\n \"success\": false,\n \"message\": \"Feed is only available for activated domains.\",\n \"data\": []\n}", "name": "" } ] }, { "name": "Retrieve Domain.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/domains\/:id", "query": [ { "key": "start_date", "value": "2026-01-01", "description": "Filter related IPs from this date (Y-m-d). Maximum selected range is 90 days.", "disabled": false }, { "key": "end_date", "value": "2026-03-31", "description": "Filter related IPs until this date (Y-m-d). Maximum selected range is 90 days.", "disabled": false }, { "key": "related_ips_page", "value": "1", "description": "The page number for related IP results.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/domains\/:id?start_date=2026-01-01&end_date=2026-03-31&related_ips_page=1", "variable": [ { "id": "id", "key": "id", "value": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "description": "The ULID of the domain." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"related_ips_page\":16,\"start_date\":\"2022-05-19\",\"end_date\":\"2052-05-17\"}" }, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\"success\":true,\"message\":\"Domain retrieved successfully.\",\"data\":{\"id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"value\":\"example.com\",\"description\":\"Primary sending domain\",\"created_at\":\"2026-03-28T10:30:00.000000Z\",\"updated_at\":\"2026-03-28T10:30:00.000000Z\",\"logo\":null,\"team\":{\"name\":\"Owner Custom Team\"},\"mail_streams\":[{\"name\":\"Transactional Stream\",\"type\":\"transactional\",\"logo\":\"https:\\\/\\\/cdn.example.com\\\/mail-streams\\\/transactional.svg\"}],\"configuration\":{\"spf_domains\":[],\"dkim_selectors\":[],\"bimi_selectors\":[],\"dmarc\":{\"valid\":true,\"record\":\"v=DMARC1; p=none;\"},\"mx\":{\"valid\":true,\"records\":[\"mx1.example.com\",\"mx2.example.com\"]},\"created_at\":\"2026-03-28T10:30:00.000000Z\",\"updated_at\":\"2026-03-28T10:30:00.000000Z\"},\"alignment\":{\"items\":[]},\"settings\":{\"estimated_message_volume\":\"1000\",\"general_settings\":{\"estimated_message_volume\":\"1000\"},\"shared_team_ids\":[],\"mail_streams\":[{\"name\":\"Transactional Stream\",\"type\":\"transactional\",\"general_settings\":[]}],\"spf_domains\":[]},\"compliance\":{\"is_compliant\":true,\"pre_send\":{\"is_compliant\":true,\"mail_streams\":[{\"name\":\"Transactional Stream\",\"type\":\"transactional\",\"is_compliant\":true,\"checks\":{\"ips\":true,\"one_click_unsub\":false,\"blocklists\":true,\"spf\":true,\"dkim\":true,\"dmarc\":true,\"tls\":true}}]},\"post_send\":{\"is_compliant\":false,\"requirements\":{\"spf\":true,\"dkim\":null,\"dmarc_alignment\":null,\"dmarc_policy\":false,\"encryption\":null,\"user_reported_spam_rate\":null,\"dns_records\":null,\"one_click_unsubscribe\":null,\"honor_unsubscribe\":null,\"message_formatting\":null},\"subdomain\":{\"domain_id\":\"mail.example.com\",\"requirements\":{\"spf\":false,\"dkim\":false,\"dmarc_alignment\":null,\"dmarc_policy\":null,\"encryption\":null,\"user_reported_spam_rate\":null,\"dns_records\":null,\"one_click_unsubscribe\":null,\"honor_unsubscribe\":null,\"message_formatting\":null}}},\"mail_streams\":[{\"name\":\"Transactional Stream\",\"type\":\"transactional\",\"is_compliant\":true,\"checks\":{\"ips\":true,\"one_click_unsub\":false,\"blocklists\":true,\"spf\":true,\"dkim\":true,\"dmarc\":true,\"tls\":true}}]},\"complaint_rate_averages\":{\"periods\":[]},\"related_ips\":{\"date_range\":{\"start_date\":\"2026-01-01 00:00:00\",\"end_date\":\"2026-03-31 23:59:59\"},\"items\":[{\"id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"value\":\"192.0.2.10\",\"description\":\"Primary sending IP\",\"created_at\":\"2026-03-28T10:30:00.000000Z\",\"updated_at\":\"2026-03-28T10:30:00.000000Z\"}],\"meta\":{\"current_page\":1,\"last_page\":1,\"per_page\":10,\"total\":0}},\"blocklists\":{\"is_blacklist\":false,\"blacklist_count\":0,\"listed_count\":0,\"listed_muted\":0,\"listed_details\":[]}}}", "name": "" } ] } ] }, { "name": "IPs", "description": "", "item": [ { "name": "Retrieve IPs.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/ips", "query": [ { "key": "page", "value": "1", "description": "The page number. Must be at least 1.", "disabled": false }, { "key": "per_page", "value": "15", "description": "The number of IPs per page. Must be at least 1. Must not be greater than 100.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/ips?page=1&per_page=15" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\"success\":true,\"message\":\"IPs retrieved successfully.\",\"data\":[{\"id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"value\":\"192.0.2.10\",\"description\":\"Primary sending IP\",\"created_at\":\"2026-03-28T10:30:00.000000Z\",\"updated_at\":\"2026-03-28T10:30:00.000000Z\"}],\"meta\":{\"current_page\":1,\"from\":1,\"last_page\":1,\"per_page\":15,\"to\":1,\"total\":1}}", "name": "" } ] }, { "name": "Retrieve IP Feed.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/ips\/:id\/feed", "query": [ { "key": "page", "value": "1", "description": "The page number for paginated feed results. Must be at least 1.", "disabled": false }, { "key": "date", "value": "2026-04-24", "description": "Filter feed items reported on or after this date, up to today. Must not be older than 90 days from today. Must be a valid date in the format Y-m-d.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/ips\/:id\/feed?page=1&date=2026-04-24", "variable": [ { "id": "id", "key": "id", "value": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "description": "The ULID of the IP." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"IP feed retrieved successfully.\",\n \"data\": [\n {\n \"reported_at\": \"Mar 28, 2026 5:30PM\",\n \"mail_stream\": \"Transactional Stream\",\n \"ip\": {\n \"id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\n \"value\": \"192.0.2.10\",\n \"description\": \"Primary sending IP\",\n \"created_at\": \"2026-03-28T10:30:00.000000Z\",\n \"updated_at\": \"2026-03-28T10:30:00.000000Z\"\n },\n \"seed_message\": {\n \"mail_from_name\": \"Test Sender\",\n \"mail_from\": \"sender@example.com\",\n \"subject\": \"Seed message\",\n \"preview_line\": \"This is a preview.\",\n \"is_compliant\": true,\n \"is_blocklisted\": false,\n \"is_test\": false\n }\n },\n {\n \"message\": \"IP is compliant.\",\n \"reported_at\": \"Mar 28, 2026 4:45PM\",\n \"mail_stream\": \"Transactional Stream\",\n \"ip\": {\n \"id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\n \"value\": \"192.0.2.10\",\n \"description\": \"Primary sending IP\",\n \"created_at\": \"2026-03-28T10:30:00.000000Z\",\n \"updated_at\": \"2026-03-28T10:30:00.000000Z\"\n },\n \"seed_message\": null\n }\n ],\n \"meta\": {\n \"current_page\": 1,\n \"from\": 1,\n \"last_page\": 2,\n \"per_page\": 15,\n \"to\": 15,\n \"total\": 16\n }\n}", "name": "" }, { "header": [], "code": 403, "body": "{\n \"success\": false,\n \"message\": \"Feed is only available for activated IPs.\",\n \"data\": []\n}", "name": "" } ] }, { "name": "Retrieve IP.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/ips\/:id", "query": [ { "key": "start_date", "value": "2026-01-01", "description": "Filter related domains from this date (Y-m-d). Maximum selected range is 90 days.", "disabled": false }, { "key": "end_date", "value": "2026-03-31", "description": "Filter related domains until this date (Y-m-d). Maximum selected range is 90 days.", "disabled": false }, { "key": "related_domains_page", "value": "1", "description": "The page number for related domain results.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/ips\/:id?start_date=2026-01-01&end_date=2026-03-31&related_domains_page=1", "variable": [ { "id": "id", "key": "id", "value": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "description": "The ULID of the IP." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"related_domains_page\":16,\"start_date\":\"2022-05-19\",\"end_date\":\"2052-05-17\"}" }, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\"success\":true,\"message\":\"IP retrieved successfully.\",\"data\":{\"id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"value\":\"192.0.2.10\",\"description\":\"Primary sending IP\",\"created_at\":\"2026-03-28T10:30:00.000000Z\",\"updated_at\":\"2026-03-28T10:30:00.000000Z\",\"logo\":null,\"team\":{\"name\":\"Owner Custom Team\"},\"mail_streams\":[{\"name\":\"Transactional Stream\",\"type\":\"transactional\",\"logo\":\"https:\\\/\\\/cdn.example.com\\\/mail-streams\\\/transactional.svg\"}],\"configuration\":{\"rdns\":\"mail.example.com\",\"fcrdns\":true,\"rdns_summary\":null,\"provider\":{\"asn\":{\"asn\":\"AS64500\",\"name\":\"Example ASN\"},\"location\":\"37.7749,-122.4194\"},\"created_at\":\"2026-03-28T10:30:00.000000Z\",\"updated_at\":\"2026-03-28T10:30:00.000000Z\"},\"settings\":{\"shared_team_ids\":[]},\"compliance\":{\"is_compliant\":true,\"sender_score\":98,\"checks\":{\"blocklists\":true,\"fcrdns\":true}},\"complaint_rate_averages\":{\"periods\":[]},\"inbox_placement_averages\":{\"periods\":[]},\"related_domains\":{\"date_range\":{\"start_date\":\"2026-01-01 00:00:00\",\"end_date\":\"2026-03-31 23:59:59\"},\"items\":[{\"id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"value\":\"example.com\",\"description\":\"Primary sending domain\",\"created_at\":\"2026-03-28T10:30:00.000000Z\",\"updated_at\":\"2026-03-28T10:30:00.000000Z\"}],\"meta\":{\"current_page\":1,\"last_page\":1,\"per_page\":10,\"total\":0}},\"blocklists\":{\"is_blacklist\":false,\"blacklist_count\":0,\"listed_count\":0,\"listed_muted\":0,\"listed_details\":[]}}}", "name": "" } ] } ] }, { "name": "Intelligence", "description": "", "item": [ { "name": "Single Email", "description": "", "item": [ { "name": "Retrieve Single Email.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/intelligence\/single-emails\/:email", "query": [], "raw": "{{baseUrl}}\/api\/v1\/intelligence\/single-emails\/:email", "variable": [ { "id": "email", "key": "email", "value": "example%40postmasterplus.com", "description": "The email address to retrieve." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":23,\"email\":\"price.amber@example.org\",\"status\":null,\"created_at\":\"2026-04-24 16:58:40\",\"updated_at\":\"2026-04-24 16:58:40\"}}", "name": "" } ] }, { "name": "Scan Single Email.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/intelligence\/single-emails\/scan", "query": [], "raw": "{{baseUrl}}\/api\/v1\/intelligence\/single-emails\/scan" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"email\":\"example@postmasterplus.com\",\"actions\":\"\\\"verification,activity,postal_append\\\"\"}" }, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":24,\"email\":\"rempel.chadrick@example.org\",\"status\":null,\"created_at\":\"2026-04-24 16:58:40\",\"updated_at\":\"2026-04-24 16:58:40\"}}", "name": "" } ] }, { "name": "Delete Single Email.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/intelligence\/single-emails\/:email", "query": [], "raw": "{{baseUrl}}\/api\/v1\/intelligence\/single-emails\/:email", "variable": [ { "id": "email", "key": "email", "value": "example%40postmasterplus.com", "description": "The email address to delete." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\"message\": \"Single email deleted.\", \"deleted\": true}", "name": "" } ] } ] } ] }, { "name": "Blocklists", "description": "", "item": [ { "name": "Blocklist Scan", "description": "", "item": [ { "name": "Start Blocklist Scan.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/blocklist\/scan\/start", "query": [], "raw": "{{baseUrl}}\/api\/v1\/blocklist\/scan\/start" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"urls\":[\"https:\\\/\\\/optipub.com\",\"https:\\\/\\\/postmasterplus.com\"],\"follow_redirects\":true}" }, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"01kq06vschgcber9cy20a73dt6\",\"status\":\"pending\",\"unique_hosts_checked\":3,\"total_hosts_detected\":null,\"urls_scanned\":0,\"urls_skipped\":0,\"blocklisted\":false,\"credits_used\":0,\"error_message\":\"\",\"started_at\":null,\"completed_at\":null},\"success\":true,\"message\":\"Blocklist check started successfully.\"}", "name": "" } ] }, { "name": "Retrieve Blocklist Scan Status.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/blocklist\/scan\/status\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/blocklist\/scan\/status\/:id", "variable": [ { "id": "id", "key": "id", "value": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "description": "The ULID of the blocklist check." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"01kq06vsd0dp49ttrf238x6ryb\",\"status\":\"pending\",\"unique_hosts_checked\":4,\"total_hosts_detected\":null,\"urls_scanned\":0,\"urls_skipped\":0,\"blocklisted\":false,\"credits_used\":0,\"error_message\":\"\",\"started_at\":null,\"completed_at\":null},\"success\":true,\"message\":\"Blocklist check status retrieved successfully.\"}", "name": "" } ] } ] } ] }, { "name": "Spam Identifiers", "description": "", "item": [ { "name": "Retrieve Spam Identifiers.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/spam-identifiers", "query": [ { "key": "domain_id", "value": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "description": "Optionally filter identifiers to a single accessible domain ULID.", "disabled": false }, { "key": "page", "value": "1", "description": "The page number for paginated identifier results.", "disabled": false }, { "key": "start_date", "value": "2026-01-22", "description": "Filter identifiers from this date (Y-m-d). Maximum selected range is 90 days.", "disabled": false }, { "key": "end_date", "value": "2026-04-22", "description": "Filter identifiers until this date (Y-m-d). Maximum selected range is 90 days.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/spam-identifiers?domain_id=01ARZ3NDEKTSV4RRFFQ69G5FAV&page=1&start_date=2026-01-22&end_date=2026-04-22" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "List all Gmail Postmaster Tools v2 spam (feedback loop) identifiers reported\nfor accessible domains in the given date range, along with each identifier's\naverage complaint rate across that window." }, "response": [ { "header": [], "code": 200, "body": "{\"success\":true,\"message\":\"Spam identifiers retrieved successfully.\",\"data\":[{\"domain\":{\"id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"value\":\"example.com\"},\"identifier\":\"66189376\",\"sample_count\":57,\"average_complaint_rate\":0.12},{\"domain\":{\"id\":\"01ARZ3NDEKTSV4RRFFQ69G5FBG\",\"value\":\"example.net\"},\"identifier\":\"66189799\",\"sample_count\":40,\"average_complaint_rate\":0.05}],\"meta\":{\"current_page\":1,\"last_page\":1,\"per_page\":25,\"total\":2}}", "name": "" } ] }, { "name": "Retrieve Spam Identifier.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/spam-identifiers\/:identifier", "query": [ { "key": "domain_id", "value": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "description": "Optionally filter the identifier to a single accessible domain ULID.", "disabled": false }, { "key": "start_date", "value": "2026-01-22", "description": "Start date of the reporting window (Y-m-d). Maximum selected range is 90 days.", "disabled": false }, { "key": "end_date", "value": "2026-04-22", "description": "End date of the reporting window (Y-m-d). Maximum selected range is 90 days.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/spam-identifiers\/:identifier?domain_id=01ARZ3NDEKTSV4RRFFQ69G5FAV&start_date=2026-01-22&end_date=2026-04-22", "variable": [ { "id": "identifier", "key": "identifier", "value": "66189376", "description": "The Gmail Postmaster Tools v2 spam (feedback loop) identifier." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return the daily Gmail complaint rate time series for a single spam\n(feedback loop) identifier across accessible domains, plus the aggregate\naverage over the selected date range for each domain." }, "response": [ { "header": [], "code": 200, "body": "{\"success\":true,\"message\":\"Spam identifier retrieved successfully.\",\"data\":[{\"identifier\":\"66189376\",\"domain\":{\"id\":\"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\"value\":\"example.com\"},\"date_range\":{\"start_date\":\"2026-01-22\",\"end_date\":\"2026-04-22\"},\"aggregate\":{\"average_complaint_rate\":0.12,\"sample_count\":57},\"time_series\":[{\"date\":\"2026-01-22\",\"complaint_rate\":0.1},{\"date\":\"2026-01-23\",\"complaint_rate\":null}]}]}", "name": "" }, { "header": [], "code": 404, "body": "{\"success\":false,\"message\":\"Spam identifier not found for accessible domains in the selected date range.\",\"data\":[]}", "name": "" } ] } ] }, { "name": "Tools", "description": "", "item": [ { "name": "Screenshot", "description": "", "item": [ { "name": "Take Screenshot.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/screenshot\/take", "query": [], "raw": "{{baseUrl}}\/api\/v1\/screenshot\/take" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"url\":\"\\\"https:\\\/\\\/example.com\\\"\",\"width\":1280,\"height\":720,\"format\":\"\\\"png\\\"\",\"device_scale\":1}" }, "description": "Take a screenshot of a URL or HTML content." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"01kq06vsdpfacepemv3gbkpvsh\",\"url\":\"https:\\\/\\\/assets.optipub.com\\\/postmaster\\\/screenshots\\\/01kq06vsdebvj0bfaaygbz1qnv\\\/01kq06vsdpfacepemv3gbkpvsh.png\",\"format\":\"png\",\"width\":1024,\"height\":600,\"device_scale\":3,\"credits_used\":1,\"started_at\":\"2026-04-14T11:00:14+00:00\",\"completed_at\":\"2026-04-14T11:00:27+00:00\",\"created_at\":\"2026-04-24T16:58:40+00:00\"},\"success\":true,\"message\":\"Screenshot taken successfully.\"}", "name": "" } ] }, { "name": "List Screenshots.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/screenshots", "query": [ { "key": "per_page", "value": "15", "description": "The number of screenshots per page (1-100). Defaults to 15. Must be at least 1. Must not be greater than 100.", "disabled": false }, { "key": "page", "value": "1", "description": "The page number. Must be at least 1.", "disabled": false }, { "key": "sort", "value": "-created_at", "description": "Sort order. Use `-` prefix for descending. Options: `created_at`, `-created_at`, `format`, `-format`. Defaults to `-created_at`.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/screenshots?per_page=15&page=1&sort=-created_at" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieve a paginated list of screenshots for the current team." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"message\": \"Screenshots retrieved successfully.\",\n \"data\": [\n {\n \"id\": \"01ARZ3NDEKTSV4RRFFQ69G5FAV\",\n \"url\": \"https:\/\/assets.optipub.com\/postmaster\/screenshots\/01arz3ndektsv4rrffq69g5fav\/01arz3ndektsv4rrffq69g5fav.png\",\n \"format\": \"png\",\n \"width\": 1280,\n \"height\": 720,\n \"credits_used\": 1,\n \"created_at\": \"2024-01-15T10:30:00Z\"\n }\n ],\n \"meta\": {\n \"current_page\": 1,\n \"from\": 1,\n \"last_page\": 5,\n \"per_page\": 15,\n \"to\": 15,\n \"total\": 75\n }\n}", "name": "" } ] }, { "name": "Get Screenshot.", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/screenshot\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/screenshot\/:id", "variable": [ { "id": "id", "key": "id", "value": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "description": "The ULID of the screenshot." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieve details of a specific screenshot by its ID." }, "response": [ { "header": [], "code": 200, "body": "{\"data\":{\"id\":\"01kq06vsendywweecn020wx6nk\",\"url\":\"https:\\\/\\\/assets.optipub.com\\\/postmaster\\\/screenshots\\\/01kq06vseekh3p1ke4zja9ywys\\\/01kq06vsendywweecn020wx6nk.png\",\"format\":\"png\",\"width\":800,\"height\":600,\"device_scale\":2,\"credits_used\":1,\"started_at\":\"2026-04-14T07:41:04+00:00\",\"completed_at\":\"2026-04-14T07:41:34+00:00\",\"created_at\":\"2026-04-24T16:58:40+00:00\"},\"success\":true,\"message\":\"Screenshot retrieved successfully.\"}", "name": "" } ] } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "key", "type": "string" } ] } }