Sign in
Letters

List Letters

Get a list of letters.

get/print-mail/v1/letters

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

Changed in 4 of the 7 revisions of this API.338

  • 537d2bbc624a33See the full diff
    • ▲

      added BinaryFile subschema #1 to the data/items/attachedPDF/allOf[AttachedPDF]/file response property oneOf list for the response status 200

      response-property-one-of-added

    • ▲

      added BinaryFile subschema #1 to the data/items/plasticCard/allOf[PlasticCard]/doubleSided/allOf[PlasticCardDoubleSided]/pdf response property oneOf list for the response status 200

      response-property-one-of-added

    • ▲

      added BinaryFile subschema #1 to the data/items/plasticCard/allOf[PlasticCard]/singleSided/allOf[PlasticCardSingleSided]/pdf response property oneOf list for the response status 200

      response-property-one-of-added

    • ○

      removed subschema #1 subschema #2 from the data/items/attachedPDF/allOf[AttachedPDF]/file response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 subschema #2 from the data/items/plasticCard/allOf[PlasticCard]/doubleSided/allOf[PlasticCardDoubleSided]/pdf response property anyOf list for the response status 200

      response-property-any-of-removed

    • ○

      removed subschema #1 subschema #2 from the data/items/plasticCard/allOf[PlasticCard]/singleSided/allOf[PlasticCardSingleSided]/pdf response property anyOf list for the response status 200

      response-property-any-of-removed

  • 54cf11f8a76f2See the full diff
    • ○

      added the optional property data/items/from/allOf[Contact]/secret to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/items/to/allOf[Contact]/secret to the response with the 200 status

      response-optional-property-added

  • afd5935c2b2c1See the full diff
    • ○

      added the optional property data/items/paper to the response with the 200 status

      response-optional-property-added

  • c8fedcbd705e32See the full diff
    • ●

      added the new internal_server_error enum value to the error/type response property for the response status 500

      response-property-enum-value-added

    • ●

      added the new rate_limit_exceeded_error enum value to the error/type response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new validation_error enum value to the error/type response property for the response status 400

      response-property-enum-value-added

    • ○

      added subschema #1 subschema #2 to the response body anyOf list for the response status 401

      response-body-any-of-added

    • ○

      removed subschema #1 subschema #2 from the response body anyOf list for the response status 401

      response-body-any-of-removed

    This revision also has 21 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog