The Lob API is organized around REST. Our API is designed to have predictable, resource-oriented URLs and uses HTTP response codes to indicate any API errors.
+ " fill="currentColor">The Lob API is organized around REST. Our API is designed to have predictable, resource-oriented URLs and uses HTTP response codes to indicate any API errors.
Lob’s Print & Mail and Address Verification APIs help companies transform outdated, manual print-and-mail processes; save 1,000s of hours in processing time by sending mail much more quickly; and increase ROI on offline communications.
@@ -3226,7 +3226,7 @@An array of tracking_event objects ordered by ascending time. Will not be populated for postcards created in test mode.
The unique ID of the associated campaign if the resource was generated from a campaign.
The use type for each mailpiece. Can be one of marketing, operational, or null. Null use_type is only allowed if an account default use_type is selected in Account Settings. For more information on use_type, see our Help Center article.
-This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 4x6 or A5 postcard sizes.
This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 4x6 or A5 postcard sizes.
A string describing the reason for failure if the postcard failed to render.
Value is resource type.
Required if to address is international. Must either be an address ID or an inline object with correct address parameters. Must either be an address ID or an inline object with correct address parameters. All addresses will be standardized into uppercase without being modified by verification.
An optional string with the billing group ID to tag your usage with. Is used for billing purposes. Requires special activation to use. See Billing Group API for more information.
Customize and place a QR code on the creative at the required position.
-This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 4x6 or A5 postcard sizes.
This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 4x6 or A5 postcard sizes.
| ratelimit-limit | integer Example: 150 The rate limit for a given endpoint. |
| ratelimit-remaining | integer Example: 100 The number of requests remaining in the current window. @@ -3338,7 +3338,7 @@3. Learn more |
Array of objects or null (tracking_event_normal) An array of tracking_event objects ordered by ascending | |
| campaign_id | string or null The unique ID of the associated campaign if the resource was generated from a campaign. |
| use_type | string or null (psc_use_type) Enum: "marketing" "operational" null The use type for each mailpiece. Can be one of marketing, operational, or null. Null use_type is only allowed if an account default use_type is selected in Account Settings. For more information on use_type, see our Help Center article. - |
| fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
| fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
| status | any (The status of the postcard.) Enum: "processed" "rendered" "failed" |
| failure_reason | string or null A string describing the reason for failure if the postcard failed to render. |
| object | string Default: "postcard" Value: "postcard" Value is resource type. |
You can input a merge variable payload object to your template to render dynamic content. For example, if you have a template like: {{variable_name}}, pass in {"variable_name": "Harry"} to render Harry. merge_variables must be an object. Any type of value is accepted as long as the object is valid JSON; you can use strings, numbers, booleans, arrays, objects, or null. The max length of the object is 25,000 characters. If you call JSON.stringify on your object, it can be no longer than 25,000 characters. Your variable names cannot contain any whitespace or any of the following special characters: !, ", #, %, &, ', (, ), *, +, ,, /, ;, <, =, >, @, [, \, ], ^, `, {, |, }, ~. More instructions can be found in our guide to using html and merge variables. Depending on your Merge Variable strictness setting, if you define variables in your HTML but do not pass them here, you will either receive an error or the variable will render as an empty string.
A timestamp in ISO 8601 format which specifies a date after the current time and up to 180 days in the future to send the letter off for production. Setting a send date overrides the default cancellation window applied to the mailpiece. Until the send_date has passed, the mailpiece can be canceled. If a date in the format 2017-11-01 is passed, it will evaluate to midnight UTC of that date (2017-11-01T00:00:00.000Z). If a datetime is passed, that exact time will be used. A send_date passed with no time zone will default to UTC, while a send_date passed with a time zone will be converted to UTC.
Specifies the size of the self mailer. The 17.75x9_trifold size is in beta. Contact support@lob.com or your account contact to learn more.
Specifies the size of the self mailer. The 17.75x9_trifold size is in beta. Contact support@lob.com or your account contact to learn more.
A date in YYYY-MM-DD format of the mailpiece's expected delivery date based on its send_date.
A timestamp in ISO 8601 format of the date the resource was created.
A timestamp in ISO 8601 format of the date the resource was last modified.
@@ -3374,7 +3374,7 @@Unique identifier prefixed with vrsn_.
Value is resource type.
An array of certified tracking events ordered by ascending time. Not populated in test mode.
This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 11x9_bifold self-mailer size.
This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 11x9_bifold self-mailer size.
A string describing the reason for failure if the self mailer failed to render.
You can input a merge variable payload object to your template to render dynamic content. For example, if you have a template like: {{variable_name}}, pass in {"variable_name": "Harry"} to render Harry. merge_variables must be an object. Any type of value is accepted as long as the object is valid JSON; you can use strings, numbers, booleans, arrays, objects, or null. The max length of the object is 25,000 characters. If you call JSON.stringify on your object, it can be no longer than 25,000 characters. Your variable names cannot contain any whitespace or any of the following special characters: !, ", #, %, &, ', (, ), *, +, ,, /, ;, <, =, >, @, [, \, ], ^, `, {, |, }, ~. More instructions can be found in our guide to using html and merge variables. Depending on your Merge Variable strictness setting, if you define variables in your HTML but do not pass them here, you will either receive an error or the variable will render as an empty string.
A timestamp in ISO 8601 format which specifies a date after the current time and up to 180 days in the future to send the letter off for production. Setting a send date overrides the default cancellation window applied to the mailpiece. Until the send_date has passed, the mailpiece can be canceled. If a date in the format 2017-11-01 is passed, it will evaluate to midnight UTC of that date (2017-11-01T00:00:00.000Z). If a datetime is passed, that exact time will be used. A send_date passed with no time zone will default to UTC, while a send_date passed with a time zone will be converted to UTC.
Specifies the size of the self mailer. The 17.75x9_trifold size is in beta. Contact support@lob.com or your account contact to learn more.
Specifies the size of the self mailer. The 17.75x9_trifold size is in beta. Contact support@lob.com or your account contact to learn more.
Required if to address is international. Must either be an address ID or an inline object with correct address parameters. Must either be an address ID or an inline object with correct address parameters. All addresses will be standardized into uppercase without being modified by verification.
An optional string with the billing group ID to tag your usage with. Is used for billing purposes. Requires special activation to use. See Billing Group API for more information.
Customize and place a QR code on the creative at the required position.
-This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 11x9_bifold self-mailer size.
This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 11x9_bifold self-mailer size.
| ratelimit-limit | integer Example: 150 The rate limit for a given endpoint. |
| ratelimit-remaining | integer Example: 100 The number of requests remaining in the current window. @@ -3474,7 +3474,7 @@3. Learn more |
| merge_variables | object or null (merge_variables) <= 25000 characters You can input a merge variable payload object to your template to render dynamic content. For example, if you have a template like: |
string or string (send_date) A timestamp in ISO 8601 format which specifies a date after the current time and up to 180 days in the future to send the letter off for production. Setting a send date overrides the default cancellation window applied to the mailpiece. Until the | |
| size | string (self_mailer_size) Default: "6x18_bifold" Enum: "6x18_bifold" "11x9_bifold" "12x9_bifold" "17.75x9_trifold" Specifies the size of the self mailer. The |
| size | string (self_mailer_size) Default: "6x18_bifold" Enum: "6x18_bifold" "11x9_bifold" "12x9_bifold" "17.75x9_trifold" Specifies the size of the self mailer. The |
Array of objects (thumbnail) | |
| expected_delivery_date | string <date> (expected_delivery_date) A date in YYYY-MM-DD format of the mailpiece's expected delivery date based on its |
| date_created | string <date-time> (date_created) A timestamp in ISO 8601 format of the date the resource was created. |
| date_modified | string <date-time> (date_modified) A timestamp in ISO 8601 format of the date the resource was last modified. @@ -3485,7 +3485,7 @@3. Learn more |
| inside_template_version_id | string or null^vrsn_[a-zA-Z0-9]+$ Unique identifier prefixed with |
| object | string Default: "self_mailer" Value: "self_mailer" Value is resource type. |
Array of objects (tracking_event_certified) An array of certified tracking events ordered by ascending | |
| fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
| fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
| status | any (The status of the self mailer.) Enum: "processed" "rendered" "failed" |
| failure_reason | string or null A string describing the reason for failure if the self mailer failed to render. |
Unique identifier prefixed with tmpl_. ID of a saved HTML template.
Unique identifier prefixed with vrsn_.
The unique ID of the associated campaign if the resource was generated from a campaign.
-This is in beta. Contact support@lob.com or your account contact to learn more. Not available for A4 letter size.
This is in beta. Contact support@lob.com or your account contact to learn more. Not available for A4 letter size.
A string describing the reason for failure if the letter failed to render.
Value is resource type.
Accepts an envelope ID for any customized envelope with available inventory. If no inventory is available for the specified ID, the letter will not be sent, and an error will be returned. If the letter has more than 6 sheets, it will be sent in a blank flat envelope. Custom envelopes may be created and ordered from the dashboard. This feature is exclusive to certain customers. Upgrade to the appropriate Print & Mail Edition to gain access.
An optional string with the billing group ID to tag your usage with. Is used for billing purposes. Requires special activation to use. See Billing Group API for more information.
Customize and place a QR code on the creative at the required position.
-This is in beta. Contact support@lob.com or your account contact to learn more. Not available for A4 letter size.
This is in beta. Contact support@lob.com or your account contact to learn more. Not available for A4 letter size.
| ratelimit-limit | integer Example: 150 The rate limit for a given endpoint. |
| ratelimit-remaining | integer Example: 100 The number of requests remaining in the current window. @@ -3666,7 +3666,7 @@3. Learn more |
| template_id | string^tmpl_[a-zA-Z0-9]+$ Unique identifier prefixed with |
| template_version_id | string^vrsn_[a-zA-Z0-9]+$ Unique identifier prefixed with |
| campaign_id | string or null The unique ID of the associated campaign if the resource was generated from a campaign. - |
| fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
| fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
| status | any (The status of the letter.) Enum: "processed" "rendered" "failed" |
| failure_reason | string or null A string describing the reason for failure if the letter failed to render. |
| object | string Default: "letter" Value: "letter" Value is resource type. |