Virtual Mailboxes

List Virtual Mailboxes

Changed on

Lists virtual mailboxes. You can use the skip, limit, and search query parameters to refine the list.

get/print-mail/v1/virtual_mailboxes

Request

  • Base URL
    https://api.postgrid.com
  • URL
    https://api.postgrid.com/print-mail/v1/virtual_mailboxes
  • Auth
    API key in header X-API-Key

Query parameters

skipinteger
limitinteger
string
OR
string

You can supply a structured search query instead of supplying unstructured text to any list endpoint help refine your search for a resource.

For example, let's say you created a series of letters that all had metadata: { campaignID: 'abc' }. You could search for all those letters by passing in { "metadata.campaignID": "abc" } into the search parameter.

Note that this string must be valid JSON.

You can supply any string to help narrow down the list of resources. For example, if you pass "New York" (quoted), it will return resources that have that string present somewhere in their response. Alternatively, you can supply a structured search query. See the documentation on StructuredSearchQuery for more details.

Response

The request has succeeded.

object'list' required
totalCountinteger required
skipinteger required
limitinteger required

Changes

  • 54cf11f8a76fRevision changes
    • info

      added the optional property //////////// to the response with the status

  • c8fedcbd705eRevision changes
    • info

      endpoint added