This section documents the V3 API endpoints that provide access to comprehensive audit and journey data from ObservePoint. Use these endpoints to retrieve detailed reports, export data, manage alerts, configure scans and privacy settings, and analyze web performance metrics from your ObservePoint scans.
v3 API//
- Read the configurations for an Email Inbox by id
Return filtered email inboxes
Get Email Inbox by id
Get all email messages associated with a given Email Inbox
Get all email messages statuses associated with a given Email Inbox
Read the configurations f...
V3 API
Download OpenAPI description
Overview
Languages
Servers
ObservePoint Production API
https://api.observepoint.com/
- ObservePoint Production APIhttps://api.observepoint.com/v3/email-inboxes/{emailInboxId}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.observepoint.com/v3/email-inboxes/{emailInboxId}' \
-H 'Authorization: YOUR_API_KEY_HERE'Response
application/json
{ "id": 10, "labelIds": [ 223 ], "name": "Christmas Marketing Campaign", "emailAddress": "scanTest+<8^[a-z0-9]>@email.observepoint.com", "notes": "string", "subscribers": { "onReceived": [ … ], "onProcessed": [ … ] }, "linkExclusionFilters": [ "string" ], "omitSocialLinks": true }
- ObservePoint Production APIhttps://api.observepoint.com/v3/email-inboxes/{emailInboxId}/audit-configurations
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.observepoint.com/v3/email-inboxes/{emailInboxId}/audit-configurations' \
-H 'Authorization: YOUR_API_KEY_HERE'Successful operation, resource found
Date-time in RFC3339 profile ISO 8601 format with the following additional restrictions:
- An uppercase T must separate the date and time portions.
- An uppercase Z must denote that a numeric time zone offset isn't present.
In general, these timestamp requirements are the same in AWS Step Functions - Choice Rules
Example: "2016-08-18T17:33:00Z"
Response
application/json
[ { "auditId": 107239, "auditName": "string", "auditLastRunAt": "2016-08-18T17:33:00Z", "auditLabels": [ … ] } ]
- ObservePoint Production APIhttps://api.observepoint.com/v3/email-inboxes/{emailInboxId}/messages
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.observepoint.com/v3/email-inboxes/{emailInboxId}/messages?page=0&size=50&emailSubject=string' \
-H 'Authorization: YOUR_API_KEY_HERE'Successful operation
Common metadata for iterable
Total number of items available from all result pages combined
Page size - number of items per result page configured by size query parameter or default page size
Enum"RECEIVED""PROCESSING""AUDITING""NOT_AUDITING""NOTIFYING""COMPLETE""FAILED""CANCELLED"
Example: "COMPLETE"
Enum"ITEM_CONCURRENCY_REACHED""ACCOUNT_CONCURRENCY_REACHED""USER_CONCURRENCY_REACHED""USAGE_LIMIT_EXCEEDED_WHEN_OVERAGE_NOT_ALLOWED""NO_AUDITS_ASSIGNED""UNABLE_TO_PROCESS_MESSAGE""NO_LINKS_FOUND""MESSAGE_NOT_FOUND""ABORTED""UNKNOWN"
Example: "NO_AUDITS_ASSIGNED"
Date-time in RFC3339 profile ISO 8601 format with the following additional restrictions:
- An uppercase T must separate the date and time portions.
- An uppercase Z must denote that a numeric time zone offset isn't present.
In general, these timestamp requirements are the same in AWS Step Functions - Choice Rules
Example: "2016-08-18T17:33:00Z"
A url that redirects to a time-limited screenshot of the email.
Example: "/v2/screenshots?token=a.b.c"
Response
application/json
{ "metadata": { "pagination": { … } }, "messages": [ { … } ] }