{"uid":"cap_kdJiI_KKN4VAVcXkfFf9q","slug":"immigrationpulse-us-visa-bulletin-decoder-1ecf0960","name":"ImmigrationPulse US Visa Bulletin Decoder","description":"US Visa Bulletin decoder / priority date tracker. Returns current priority dates, green card wait-time estimates, filing-chart guidance, and movement trends across all EB and family preference categories. For immigration and visa agents.","url":"https://immigrationpulse.vercel.app/api/bulletin","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"lang":{"type":"string","description":"lang"},"category":{"type":"string","description":"Preference category: EB-1|EB-2|EB-3|EB-4|EB-5|F-1|F-2A|F-2B|F-3|F-4 (default: EB-2)"},"chargeability":{"type":"string","description":"Country of chargeability, usually birth country (default: India)"},"priority_date":{"type":"string","description":"Your priority date (YYYY-MM-DD) — enables personalized filing eligibility check"}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0OxMXDvfQ-_7cxwiur9SI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Decodes the USCIS Visa Bulletin to return priority dates, wait-time estimates, filing-chart guidance, and movement trends across all preference categories.","exampleAgentPrompt":"What does the latest USCIS Visa Bulletin show for EB-2 India — what's the current priority date, is it moving forward or retrogressing, and can I use the dates for filing chart right now?","exampleUseCases":[{"title":"Track visa category movement trends","prompt":"I'm on the EB-3 waitlist for China and need to understand if the priority dates are moving forward or if I should expect delays — what does the latest bulletin show for my category?"},{"title":"Determine current filing eligibility status","prompt":"My priority date is August 2021 for EB-2 Rest of World — based on today's visa bulletin, am I current and able to file my adjustment of status application right now?"},{"title":"Estimate green card wait times","prompt":"Can you check the F2A family preference category and tell me roughly how long someone with a priority date from last year would typically wait to become current at this rate of movement?"}],"resultDescription":"Returns structured data from the USCIS Visa Bulletin including priority dates for each preference category and country of chargeability, filing chart vs. final action date guidance, estimated wait times, and recent movement trends (advancement or retrogression).","failureModes":["Visa bulletin not yet published for a requested month — returns error or null data","Invalid or unrecognized preference category input — may return empty result","Country of chargeability not recognized — may default to rest-of-world or return error","Bulletin data unavailable due to upstream USCIS changes — stale or missing data","Network timeout or Vercel cold-start delay on infrequent calls"],"whenToPreferThis":"Use this endpoint when you need structured, decoded Visa Bulletin data including priority dates, movement trends, and filing eligibility guidance for any US immigrant visa preference category. Ideal for immigration agents and legal tools that need to answer client questions about whether their priority date is current or estimate how long they may wait.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:37:39.096Z","isFirstParty":false}