An official website of the United States government
Official websites use .gov A .gov website belongs to an official government organization in the United States.
Secure .gov websites use HTTPS A lock or https:// means you've safely connected to the .gov website. Share sensitive information only on official, secure websites.
Applications you register here can request taxpayer authorization through OAuth 2.0 and call IRS APIs on their behalf.
You haven't registered an application yet
Register an OAuth application to get credentials, choose the scopes it may request, and start calling IRS APIs in the sandbox — no approval needed until you request production access.
How it works
Three steps from registration to your first API call.
1
Set up your developer profile
Tell us who is responsible for the application — an individual developer or an organization.
2
Register your application
Name it, add a redirect URI, and select the scopes taxpayers will be asked to approve.
3
Get credentials and build
Receive a client ID and secret, test in the sandbox, then request production access.
Your application was created. Sandbox credentials are active now — request production access from the application page when you're ready.
New secret issued. The previous secret stops working in 24 hours.
Requesting a token
Authorization code flow with PKCE. After the taxpayer approves access, exchange the code for an access and refresh token.
# Exchange an authorization code
POST /oauth/v1/token
Host: api.irs.gov
grant_type=authorization_code
&code=SplxlOBeZQQYbYS6WxSbIA
&client_id=irs_app_7f3k2m9qv81d
&code_verifier=dBjftJeZ4CVP...
&redirect_uri=https://app.ledgerly
.example/oauth/callback
Scopes
Select the scopes this application may request. Taxpayers see each scope in plain language on the consent screen and can decline any request. Scopes you don't select here can never be requested.
Individual Online Account Available
Income verification (IVES) Available
Business Tax Account Coming soon
Tax professionals Coming soon
API catalog
Every API is versioned REST with JSON responses and OAuth 2.0 bearer tokens. One authorization model across individual, business, tax professional, and transmitter surfaces.
APIs available on the platform, their base paths, and availability status
API
Base path
Status
Individual Account API
Balances, payment activity, transcripts, refund status, and notices for individual taxpayers.
/v1/individual
Available
Payments API
Create, schedule, and cancel Direct Pay payments with taxpayer authorization.
/v1/payments
Available
Income Verification (IVES) API
Consent-based income verification for lenders — report delivered in minutes, not days.
/v1/ives
Available
Transcript Delivery API
Transcript retrieval for authorized tax professionals and reporting agents.
/v1/transcripts
Coming soon
MeF Submission API
Modernized e-File return submission and acknowledgements over REST for transmitters.
/v1/mef
Coming soon
TIN Matching API
Real-time payee TIN/name matching for payers and their software.
/v1/tin-match
Coming soon
LT
Ledgerly Tax Assistant
app.ledgerly.example
Ledgerly Tax Assistant wants to access your IRS account
View your account balance and payment historyBalance due and payments for each tax year.
View your transcriptsReturn and wage & income transcripts.
View your refund statusStatus for the current and two prior years.
Schedule payments you approveFrom a bank account you designate. Each payment requires your confirmation in Ledgerly.
Ledgerly Tax Assistant will have access until you remove it. Access renews automatically for up to 90 days at a time; after that you'll sign in here again. You can review or remove this connection any time under Connected apps in your IRS online account. The IRS never shares your password with this application.
Access allowed
Returning you to Ledgerly Tax Assistant. It can now act on the permissions you approved — nothing more.
ConnectedToday
Access renewsAutomatically, up to 90 days at a time
Applications you've allowed to access your IRS account. Each app can only do what you approved on its consent screen — remove its access here at any time.
LT
Ledgerly Tax Assistant
Connected today · Last activity today · Ledgerly Software LLC
Connected February 2, 2026 · Last activity April 15, 2026 · TurboPrep Inc.
TranscriptsRefund status
MA
Morales Household Agent
Connected May 20, 2026 · Last activity yesterday · Personal app registered by Avery Morales
Balance & paymentsNoticesSchedule payments
Removing an app cancels its access and refresh tokens immediately. Payments the app already scheduled stay scheduled — cancel those under Payment activity.