The form library

Search the forms Emboss already knows and create one from its slug instead of uploading a file.

List or search the library

GET/libraryNo auth

With no query, lists every active form in the library. Authenticated with a q parameter, searches by slug, title and alias. No query means no auth is required; a search with q requires a Bearer key.

Parameters

NameInTypeRequiredDescription
qquerystringnoOptional. Free text matched against each form's slug, title and aliases, case-insensitive, ignoring punctuation. Requires a Bearer key when given.

Status codes

  • 200The matching (or, with no query, every active) library form. An empty list is still 200.
  • 401q was given without a valid API key.
  • 429Rate limit exceeded.
curl "https://api.getemboss.ai/library?q=w-9" \
  -H "Authorization: Bearer sk_..."
Response
{
  "results": [
    { "slug": "irs-w-9", "title": "Form W-9, Request for Taxpayer Identification Number and Certification", "agency": "IRS", "revision": "Rev. March 2024", "page_count": 6 }
  ]
}