Lob.com Postcards API is one of 32 APIs that Lob.com publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Postcards. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes
4 operations
across 2 paths,
and defines 59 schemas.
It is described by OpenAPI 3.2.0, at version 1.22.0.
Requests are made against a single base URL, https://api.lob.com/v1.
The identity and technical contract details declared by the specification.
Postcards 4
The postcards endpoint allows you to easily print and mail postcards. The API provides endpoints for creating postcards, retrieving individual postcards, canceling postcards, and…
GET
/postcards/{psc_id}
Retrieve
postcard_retrieve
1 param
→ 200default
DELETE
/postcards/{psc_id}
Cancel
postcard_delete
1 param
→ 200default
GET
/postcards
List
postcards_list
12 params
→ 200default
POST
/postcards
Create
postcard_create
2 params
body
→ 200default
tmpl_id
string
Unique identifier prefixed with tmpl. ID of a saved [HTML template](section/HTML-Templates).
error
object
Lob uses RESTful HTTP response codes to indicate success or failure of an API request. In general, 2xx indicates success, 4xx indicate an input error, and 5xx…
1 property
1 required
company
stringnull
Either name or company is required, you may also add both. Must be no longer than 40 characters. If both name and company are provided, they will be printed on…
failure_reason
object
An object describing the reason for failure if the resource failed to render.
3 properties
local_file_path
string
The path to a local file.
date_filter
object
Filter by ISO-8601 date or datetime, e.g. { "gt": "2012-01-01", "lt": "2012-01-31T12:34:56Z" } where gt is , lt is <, gte is ≥, and lte is ≤.
failure_status_code
integer
A conventional HTTP status code: 401 - Authorization error with your API key or account 403 - Forbidden error with your API key or account 404 - The requested…
adr_id
string
Unique identifier prefixed with adr.
date_created
string
A timestamp in ISO 8601 format of the date the resource was created.
editable
object
6 properties
print_speed
stringnull
A string designating the mail speed type: core - 2 production business days
evnt_id
string
Unique identifier prefixed with evnt.
address_fields_us
object
5 properties
4 required
mail_type
string
A string designating the mail postage type: uspsfirstclass - (default) uspsstandard - a cheaper option which is less predictable and takes longer to deliver. u…
address_fields_intl
object
5 properties
2 required
deleted
boolean
Only returned if the resource has been successfully deleted.
thumbnail
object
3 properties
signed_link
string
A [signed link](section/Asset-URLs) served over HTTPS. The link returned will expire in 30 days to prevent mis-sharing. Each time a GET request is initiated, a…
postcard_size
string
Specifies the size of the postcard. Only 4x6 postcards can be sent to international destinations.
date_modified
string
A timestamp in ISO 8601 format of the date the resource was last modified.
failure_reason_error
object
Failure error details
7 properties
psc_back
The artwork to use as the back of your postcard. Notes: - HTML merge variables should not include delimiting whitespace. - PDF, PNG, and JPGs must be sized at…
country_extended
string
Must be a 2 letter country short-name code (ISO 3166). Does not accept US, AS, PR, FM, GU, MH, MP, PW, or VI. For these addresses, please use the US verificati…
input_from_us
object
1 property
remote_file_url
string
The location of a remote file. Remote URLs have a 5 MB file size limit and must be downloaded within 40 seconds.
psc_use_type
stringnull
The use type for each mailpiece. Can be one of marketing, operational, or null. Null usetype is only allowed if an account default usetype is selected in Accou…
input_to
object
1 property
expected_delivery_date
string
A date in YYYY-MM-DD format of the mailpiece's expected delivery date based on its senddate.
billing_group_id
string
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 fo…
count
integer
number of resources in a set
html_string
string
An HTML string of under 10,000 characters.
postcard_deletion
object
Lob uses RESTful HTTP response codes to indicate success or failure of an API request. In general, 2xx indicates success, 4xx indicate an input error, and 5xx…
2 properties
resource_description
stringnull
An internal description that identifies this resource. Must be no longer than 255 characters.
psc_front
The artwork to use as the front of your postcard. Notes: - HTML merge variables should not include delimiting whitespace. - PDF, PNG, and JPGs must be sized at…
merge_variables
objectnull
You can input a merge variable payload object to your template or QR code redirect URLs to render dynamic content. For example, if you have a template like: {{…
send_date
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…
lob_base
object
4 properties
3 required
metadata
object
Use metadata to store custom information for tagging and labeling back to your internal systems. Must be an object with up to 20 key-value pairs. Keys must be…
from_us
object
1 property
status
string
A string describing the PDF render status: processed - the rendering process is currently in progress. rendered - a PDF has been successfully rendered of the m…
generated
object
7 properties
2 required
list
object
Multiple items returned in order
5 properties
campaign_id
stringnull
Denotes resources created by the provided campaign id, prefixed with cmp. In the case of snap packs, booklets, and letters with size uslegal, however, the camp…
tracking_event_base
object
As mail pieces travel through the mail stream, USPS scans their unique barcodes, and Lob processes these mail scans to generate tracking events.
5 properties
4 required
object
string
Value is resource type.
qr_code
object
Customize and place a QR code on the creative at the required position.
10 properties
3 required
psc_id
string
Unique identifier prefixed with psc.
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Lob.com publishes across the network.
