{"uid":"cap_RJJQj5yYV_C3BWgVQAazL","slug":"tiresapi-com-310e0829","name":"TiresAPI Free-Form Data Request","description":"Submit a free-form data request. Always queued; the data team triages and replies out-of-band. Use for ad-hoc asks that don't fit retailer-coverage (e.g. \"add support for retailer X\" or \"backfill historical pricing for sku Y\").","url":"https://tiresapi.com/api/v1/requests/data","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"notes":{"type":"string","maxLength":2000},"free_form":{"type":"string","maxLength":8000,"minLength":4,"description":"Free-form request text. 4–8000 characters."}}},"responseSchema":{"type":"json","example":{"notes":"Request queued for the data team to triage.","status":"queued","amount_usd":"0.010","request_id":4013,"request_type":"general_request"}},"example":{"request":{"notes":"Test request for QA validation of data request submission endpoint","free_form":"Please add retailer coverage for Discount Tire Direct and backfill historical pricing data for tire SKU MICH-P215-65R17-94T. This data is needed for our inventory reconciliation project."},"response":{"notes":"Request queued for the data team to triage.","status":"queued","amount_usd":"0.010","request_id":8,"request_type":"general_request"}},"exampleRequest":{"notes":"Test request for QA validation of data request submission endpoint","free_form":"Please add retailer coverage for Discount Tire Direct and backfill historical pricing data for tire SKU MICH-P215-65R17-94T. This data is needed for our inventory reconciliation project."},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_B4uFt6swUi8KVOVGtf55h","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a free-form, ad-hoc data request to the TiresAPI data team for manual triage and out-of-band fulfillment, covering asks like adding retailer coverage or backfilling historical pricing.","exampleAgentPrompt":"Submit a data request to TiresAPI asking them to add support for retailer Discount Tire Direct and backfill historical pricing for SKU key_brand_mpc=MICH-P215-65R17-94T — this doesn't fit the standard inventory or pricing endpoints.","exampleUseCases":[{"title":"Add new regional tire retailer coverage","prompt":"Can you submit a request to TiresAPI asking them to start tracking inventory and pricing for Tire Kingdom stores across the Southeast? We need historical data going back three months if possible."},{"title":"Backfill pricing history for discontinued tire models","prompt":"Send a data request to TiresAPI asking them to backfill six months of historical pricing for the Bridgestone Turanza EL400-02 in size 205/55R16. We're analyzing price trends for a report and need the complete dataset."},{"title":"Request custom ZIP code retailer tracking","prompt":"I need you to ask TiresAPI to start monitoring tire availability and pricing for all retailers in the 75201 and 75202 Dallas ZIP codes. Can you submit that as a data gap request and flag it as urgent for our regional inventory planning?"}],"resultDescription":"Returns a queued request confirmation, typically including a request ID or acknowledgement that the data team has received the free-form request and will triage and respond out-of-band.","failureModes":["Missing or empty request body — returns 400 Bad Request","Authentication or payment failure — returns 402 or 401","Service unavailable — returns 503 if queue is down","Malformed JSON payload — returns 400 with validation error"],"whenToPreferThis":"Use this endpoint when your data need doesn't map to any existing TiresAPI endpoint — specifically when you want to request new retailer coverage, backfill historical SKU pricing, or flag any ad-hoc gap in the dataset. Do not use this for real-time inventory lookups, price history queries, or SQL sandbox queries — those have dedicated endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:36:51.904Z","isFirstParty":false}