{"uid":"cap_SiJ8dxpQZDWImC3sVQYyf","slug":"shovels-tags-permit-classification-tag-listing-a868a88b","name":"Shovels Tags - Permit Classification Tag Listing","description":"Shovels Tags — list all available permit classification tags (and their descriptions) for use as `permit_tags` filters.","url":"https://www.stable-shovels.dev/api/tags","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"size":{"type":"integer","maximum":100,"minimum":1,"description":"Records to return per page (1–100, default 50). Determines the price — each record returned costs one credit."},"cursor":{"type":"string","description":"Pagination cursor — pass the `next_cursor` from a prior page."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_y4SnRhsB8EfdVqBxWNPT6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lists all available permit classification tags and their descriptions that can be used as filter values when querying permit data.","exampleAgentPrompt":"Show me all the permit classification tags available in Shovels so I can figure out which tag values to use when filtering permit searches — return up to 100 tags per page.","exampleUseCases":[{"title":"Building a permit search filter UI","prompt":"I'm building a permit search tool and need to populate a dropdown with all available permit tag options from Shovels — can you fetch the full list of tags and their descriptions?"},{"title":"Discovering permit categories before querying","prompt":"Before I search for permits, I want to know what permit_tags values I can actually filter by in Shovels — fetch all available classification tags so I can pick the right ones."},{"title":"Paginating through large tag catalog","prompt":"Get me all the Shovels permit tags, 50 at a time, and keep paginating until you've retrieved the full list so I have every classification label and its description."}],"resultDescription":"A paginated list of permit classification tag objects, each containing a tag identifier/name and a human-readable description of what kind of permits it classifies. Also includes a next_cursor value for fetching subsequent pages.","failureModes":["Invalid cursor string causes pagination error","Size parameter outside 1-100 range returns validation error","Unauthenticated or unpaid request (x402 payment required) returns 402 Payment Required","Empty result set if no tags exist in the system","Network timeout for large page sizes"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate all valid permit_tags filter values before constructing permit queries against Shovels data. This is a prerequisite lookup step — call it first to know what tag values are supported, then use those tags to filter actual permit searches.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:38:52.074Z","isFirstParty":false}