Filing Your Taxes Online is Fast, Easy and Secure.
Start now and receive your tax refund in as little as 7 days.

1. Get Answers

Your online questions are customized to your unique tax situation.

2. Maximize your Refund

Find tax credits for everything from school tuition to buying a hybri

3. E-File for FREE

E-file free with direct deposit to get your refund in as few as 7 days.

Filing your taxes with paper mail can be difficult and it could take weeks for your refund to arrive. IRS e-file is easy, fast and secure. There is no paperwork going to the IRS so tax refunds can be processed in as little as 7 days with direct deposit. As you prepare your taxes online, you can see your tax refund in real time.

FREE audit support and representation from an enrolled agent – NEW and only from H&R Block

File A 1040x Amended Return

How To File An Amended Tax Return For 2013Federal Tax Return Forms 1040ezIrs Tax Form 1120 For 2012Free Filing H&r BlockHow To Do Amended Tax Return On TurbotaxIrs Forms 10401040x Form For 2010Amend My Tax Return1040x Online FreeFree Tax Filing For Federal And StateTax Forms For 2008State Tax File For FreeState Income Tax AddressWebsite Efile Past Year Tax Returns1040ez RefundTaxes For 20102013 Ez Tax FormAmend A Tax Return 2011Ez 1040 FormFree 2011 Tax Return Online2010 Form 1040Irs Form 1040 EzFile 2006 Taxes Online2011 1040 Ez FormMyfreetaxes Com TucsonAmended 2010 Tax Return2011 1040 Ez1040nr EfileIncome Tax Preparation SeniorsHelp Filling Out 1040x FormFederal Tax Forms For 20111040ez 2010Penalty For Filing Taxes LateFiling A 1040 EzH&r Block Free TaxesIrs Forms Instructions 1040ezCan I Efile 2011 TaxesHow To File 1040nr OnlineWhere Can I File My 2012 Taxes OnlineTaxact2011

File A 1040x Amended Return

File a 1040x amended return 4. File a 1040x amended return   Reporting Gains and Losses Table of Contents Introduction Topics - This chapter discusses: Useful Items - You may want to see: Information Returns Schedule D and Form 8949Long and Short Term Net Gain or Loss Treatment of Capital Losses Capital Gains Tax Rates Form 4797Mark-to-market election. File a 1040x amended return Introduction This chapter explains how to report capital gains and losses and ordinary gains and losses from sales, exchanges, and other dispositions of property. File a 1040x amended return Although this discussion refers to Schedule D (Form 1040) and Form 8949, many of the rules discussed here also apply to taxpayers other than individuals. File a 1040x amended return However, the rules for property held for personal use usually will not apply to taxpayers other than individuals. File a 1040x amended return Topics - This chapter discusses: Information returns Schedule D (Form 1040) Form 4797 Form 8949 Useful Items - You may want to see: Publication 550 Investment Income and Expenses 537 Installment Sales Form (and Instructions) Schedule D (Form 1040) Capital Gains and Losses 1099-B Proceeds From Broker and Barter Exchange Transactions 1099-S Proceeds From Real Estate Transactions 4684 Casualties and Thefts 4797 Sales of Business Property 6252 Installment Sale Income 6781 Gains and Losses from Section 1256 Contracts and Straddles 8824 Like-Kind Exchanges 8949 Sales and Other Dispositions of Capital Assets See chapter 5 for information about getting publications and forms. File a 1040x amended return Information Returns If you sell or exchange certain assets, you should receive an information return showing the proceeds of the sale. File a 1040x amended return This information is also provided to the IRS. File a 1040x amended return Form 1099-B. File a 1040x amended return   If you sold property, such as stocks, bonds, or certain commodities, through a broker, you should receive Form 1099-B, Proceeds From Broker and Barter Exchange Transactions, or a substitute statement from the broker. File a 1040x amended return Use the Form 1099-B or a substitute statement to complete Form 8949 and/or Schedule D. File a 1040x amended return Whether or not you receive 1099-B, you must report all taxable sales of stock, bonds, commodities, etc. File a 1040x amended return on Form 8949 and/or Schedule D, as applicable. File a 1040x amended return For more information on figuring gains and losses from these transactions, see chapter 4 in Publication 550. File a 1040x amended return For information on reporting the gains and losses, see the Instructions for Form 8949 and the Instructions for Schedule D (Form 1040). File a 1040x amended return Form 1099-S. File a 1040x amended return   An information return must be provided on certain real estate transactions. File a 1040x amended return Generally, the person responsible for closing the transaction (the “real estate reporting person”) must report on Form 1099-S sales or exchanges of the following types of property. File a 1040x amended return Land (improved or unimproved), including air space. File a 1040x amended return An inherently permanent structure, including any residential, commercial, or industrial building. File a 1040x amended return A condominium unit and its related fixtures and common elements (including land). File a 1040x amended return Stock in a cooperative housing corporation. File a 1040x amended return If you sold or exchanged any of the above types of property, the “real estate reporting person” must give you a copy of Form 1099-S or a statement containing the same information as the Form 1099-S. File a 1040x amended return The “real estate reporting person” could include the buyer's attorney, your attorney, the title or escrow company, a mortgage lender, your broker, the buyer's broker, or the person acquiring the biggest interest in the property. File a 1040x amended return   For more information see chapter 4 in Publication 550. File a 1040x amended return Also, see the Instructions for Form 8949. File a 1040x amended return Schedule D and Form 8949 Form 8949. File a 1040x amended return   Individuals, corporations, and partnerships, use Form 8949 to report the following. File a 1040x amended return    Sales or exchanges of capital assets, including stocks, bonds, etc. File a 1040x amended return , and real estate (if not reported on another form or schedule such as Form 4684, 4797, 6252, 6781, or 8824). File a 1040x amended return Include these transactions even if you did not receive a Form 1099-B or 1099-S. File a 1040x amended return Gains from involuntary conversions (other than from casualty or theft) of capital assets not held for business or profit. File a 1040x amended return Nonbusiness bad debts. File a 1040x amended return   Individuals, If you are filing a joint return, complete as many copies of Form 8949 as you need to report all of your and your spouse's transactions. File a 1040x amended return You and your spouse may list your transactions on separate forms or you may combine them. File a 1040x amended return However, you must include on your Schedule D the totals from all Forms 8949 for both you and your spouse. File a 1040x amended return    Corporations and electing large partnerships also use Form 8949 to report their share of gain or loss from a partnership, S Corporation, estate or trust. File a 1040x amended return   Business entities meeting certain criteria, may have an exception to some of the normal requirements for completing Form 8949. File a 1040x amended return See the Instructions for Form 8949. File a 1040x amended return Schedule D. File a 1040x amended return    Use Schedule D (Form 1040) to figure the overall gain or loss from transactions reported on Form 8949, and to report certain transactions you do not have to report on Form 8949. File a 1040x amended return Before completing Schedule D, you may have to complete other forms as shown below. File a 1040x amended return    Complete all applicable lines of Form 8949 before completing lines 1b, 2, 3, 8b, 9, or 10 of your applicable Schedule D. File a 1040x amended return Enter on Schedule D the combined totals from all your Forms 8949. File a 1040x amended return For a sale, exchange, or involuntary conversion of business property, complete Form 4797 (discussed later). File a 1040x amended return For a like-kind exchange, complete Form 8824. File a 1040x amended return See Reporting the exchange under Like-Kind Exchanges in chapter 1. File a 1040x amended return For an installment sale, complete Form 6252. File a 1040x amended return See Publication 537. File a 1040x amended return For an involuntary conversion due to casualty or theft, complete Form 4684. File a 1040x amended return See Publication 547, Casualties, Disasters, and Thefts. File a 1040x amended return For a disposition of an interest in, or property used in, an activity to which the at-risk rules apply, complete Form 6198, At-Risk Limitations. File a 1040x amended return See Publication 925, Passive Activity and At-Risk Rules. File a 1040x amended return For a disposition of an interest in, or property used in, a passive activity, complete Form 8582, Passive Activity Loss Limitations. File a 1040x amended return See Publication 925. File a 1040x amended return For gains and losses from section 1256 contracts and straddles, complete Form 6781. File a 1040x amended return See Publication 550. File a 1040x amended return Personal-use property. File a 1040x amended return   Report gain on the sale or exchange of property held for personal use (such as your home) on Form 8949 and Schedule D (Form 1040), as applicable. File a 1040x amended return Loss from the sale or exchange of property held for personal use is not deductible. File a 1040x amended return But if you had a loss from the sale or exchange of real estate held for personal use for which you received a Form 1099-S, report the transaction on Form 8949 and Schedule D, even though the loss is not deductible. File a 1040x amended return See the Instructions for Schedule D (Form 1040) and the Instructions for Form 8949 for information on how to report the transaction. File a 1040x amended return Long and Short Term Where you report a capital gain or loss depends on how long you own the asset before you sell or exchange it. File a 1040x amended return The time you own an asset before disposing of it is the holding period. File a 1040x amended return If you received a Form 1099-B, (or substitute statement) box 1c may help you determine whether the gain or loss is short-term or long-term. File a 1040x amended return If you hold a capital asset 1 year or less, the gain or loss from its disposition is short term. File a 1040x amended return Report it in Part I of Form 8949 and/or Schedule D, as applicable. File a 1040x amended return If you hold a capital asset longer than 1 year, the gain or loss from its disposition is long term. File a 1040x amended return Report it in Part II of Form 8949 and/or Schedule D, as applicable. File a 1040x amended return   Table 4-1. File a 1040x amended return Do I Have a Short-Term or Long-Term Gain or Loss? IF you hold the property. File a 1040x amended return . File a 1040x amended return . File a 1040x amended return  THEN you have a. File a 1040x amended return . File a 1040x amended return . File a 1040x amended return 1 year or less, Short-term capital gain or  loss. File a 1040x amended return More than 1 year, Long-term capital gain or  loss. File a 1040x amended return These distinctions are essential to correctly arrive at your net capital gain or loss. File a 1040x amended return Capital losses are allowed in full against capital gains plus up to $3,000 of ordinary income. File a 1040x amended return See Capital Gains Tax Rates, later. File a 1040x amended return Holding period. File a 1040x amended return   To figure if you held property longer than 1 year, start counting on the day following the day you acquired the property. File a 1040x amended return The day you disposed of the property is part of your holding period. File a 1040x amended return Example. File a 1040x amended return If you bought an asset on June 19, 2012, you should start counting on June 20, 2012. File a 1040x amended return If you sold the asset on June 19, 2013, your holding period is not longer than 1 year, but if you sold it on June 20, 2013, your holding period is longer than 1 year. File a 1040x amended return Patent property. File a 1040x amended return   If you dispose of patent property, you generally are considered to have held the property longer than 1 year, no matter how long you actually held it. File a 1040x amended return For more information, see Patents in chapter 2. File a 1040x amended return Inherited property. File a 1040x amended return   If you inherit property, you are considered to have held the property longer than 1 year, regardless of how long you actually held it. File a 1040x amended return Installment sale. File a 1040x amended return   The gain from an installment sale of an asset qualifying for long-term capital gain treatment in the year of sale continues to be long term in later tax years. File a 1040x amended return If it is short term in the year of sale, it continues to be short term when payments are received in later tax years. File a 1040x amended return    The date the installment payment is received determines the capital gains rate that should be applied not the date the asset was sold under an installment contract. File a 1040x amended return Nontaxable exchange. File a 1040x amended return   If you acquire an asset in exchange for another asset and your basis for the new asset is figured, in whole or in part, by using your basis in the old property, the holding period of the new property includes the holding period of the old property. File a 1040x amended return That is, it begins on the same day as your holding period for the old property. File a 1040x amended return Example. File a 1040x amended return You bought machinery on December 4, 2012. File a 1040x amended return On June 4, 2013, you traded this machinery for other machinery in a nontaxable exchange. File a 1040x amended return On December 5, 2013, you sold the machinery you got in the exchange. File a 1040x amended return Your holding period for this machinery began on December 5, 2012. File a 1040x amended return Therefore, you held it longer than 1 year. File a 1040x amended return Corporate liquidation. File a 1040x amended return   The holding period for property you receive in a liquidation generally starts on the day after you receive it if gain or loss is recognized. File a 1040x amended return Profit-sharing plan. File a 1040x amended return   The holding period of common stock withdrawn from a qualified contributory profit-sharing plan begins on the day following the day the plan trustee delivered the stock to the transfer agent with instructions to reissue the stock in your name. File a 1040x amended return Gift. File a 1040x amended return   If you receive a gift of property and your basis in it is figured using the donor's basis, your holding period includes the donor's holding period. File a 1040x amended return For more information on basis, see Publication 551, Basis of Assets. File a 1040x amended return Real property. File a 1040x amended return   To figure how long you held real property, start counting on the day after you received title to it or, if earlier, the day after you took possession of it and assumed the burdens and privileges of ownership. File a 1040x amended return   However, taking possession of real property under an option agreement is not enough to start the holding period. File a 1040x amended return The holding period cannot start until there is an actual contract of sale. File a 1040x amended return The holding period of the seller cannot end before that time. File a 1040x amended return Repossession. File a 1040x amended return   If you sell real property but keep a security interest in it and then later repossess it, your holding period for a later sale includes the period you held the property before the original sale, as well as the period after the repossession. File a 1040x amended return Your holding period does not include the time between the original sale and the repossession. File a 1040x amended return That is, it does not include the period during which the first buyer held the property. File a 1040x amended return Nonbusiness bad debts. File a 1040x amended return   Nonbusiness bad debts are short-term capital losses. File a 1040x amended return For information on nonbusiness bad debts, see chapter 4 of Publication 550. File a 1040x amended return    Net Gain or Loss The totals for short-term capital gains and losses and the totals for long-term capital gains and losses must be figured separately. File a 1040x amended return Net short-term capital gain or loss. File a 1040x amended return   Combine your short-term capital gains and losses, including your share of short-term capital gains or losses from partnerships, S corporations, and fiduciaries and any short-term capital loss carryover. File a 1040x amended return Do this by adding all your short-term capital gains. File a 1040x amended return Then add all your short-term capital losses. File a 1040x amended return Subtract the lesser total from the other. File a 1040x amended return The result is your net short-term capital gain or loss. File a 1040x amended return Net long-term capital gain or loss. File a 1040x amended return   Follow the same steps to combine your long-term capital gains and losses. File a 1040x amended return Include the following items. File a 1040x amended return Net section 1231 gain from Part I, Form 4797, after any adjustment for nonrecaptured section 1231 losses from prior tax years. File a 1040x amended return Capital gain distributions from regulated investment companies (mutual funds) and real estate investment trusts. File a 1040x amended return Your share of long-term capital gains or losses from partnerships, S corporations, and fiduciaries. File a 1040x amended return Any long-term capital loss carryover. File a 1040x amended return The result from combining these items with other long-term capital gains and losses is your net long-term capital gain or loss. File a 1040x amended return Net gain. File a 1040x amended return   If the total of your capital gains is more than the total of your capital losses, the difference is taxable. File a 1040x amended return Different tax rates may apply to the part that is a net capital gain. File a 1040x amended return See Capital Gains Tax Rates, later. File a 1040x amended return Net loss. File a 1040x amended return   If the total of your capital losses is more than the total of your capital gains, the difference is deductible. File a 1040x amended return But there are limits on how much loss you can deduct and when you can deduct it. File a 1040x amended return See Treatment of Capital Losses, next. File a 1040x amended return    Treatment of Capital Losses If your capital losses are more than your capital gains, you can deduct the difference as a capital loss deduction even if you do not have ordinary income to offset it. File a 1040x amended return The yearly limit on the amount of the capital loss you can deduct is $3,000 ($1,500 if you are married and file a separate return). File a 1040x amended return Table 4-2. File a 1040x amended return Holding Period for Different Types of Acquisitions Type of acquisition: When your holding period starts: Stocks and bonds bought on a securities market Day after trading date you bought security. File a 1040x amended return Ends on trading date you sold security. File a 1040x amended return U. File a 1040x amended return S. File a 1040x amended return Treasury notes and bonds If bought at auction, day after notification of bid acceptance. File a 1040x amended return If bought through subscription, day after subscription was submitted. File a 1040x amended return Nontaxable exchanges Day after date you acquired old property. File a 1040x amended return Gift If your basis is giver's adjusted basis, same day as giver's holding period began. File a 1040x amended return If your basis is FMV, day after date of gift. File a 1040x amended return Real property bought Generally, day after date you received title to the property. File a 1040x amended return Real property repossessed Day after date you originally received title to the property, but does not include time between the original sale and date of repossession. File a 1040x amended return Capital loss carryover. File a 1040x amended return   Generally, you have a capital loss carryover if either of the following situations applies to you. File a 1040x amended return Your net loss is more than the yearly limit. File a 1040x amended return Your taxable income without your deduction for exemptions is less than zero. File a 1040x amended return If either of these situations applies to you for 2013, see Capital Losses under Reporting Capital Gains and Losses in chapter 4 of Publication 550 to figure the amount you can carryover to 2014. File a 1040x amended return Example. File a 1040x amended return Bob and Gloria Sampson sold property in 2013. File a 1040x amended return The sale resulted in a capital loss of $7,000. File a 1040x amended return The Sampsons had no other capital transactions. File a 1040x amended return On their joint 2013 return, the Sampsons deduct $3,000, the yearly limit. File a 1040x amended return They had taxable income of $2,000. File a 1040x amended return The unused part of the loss, $4,000 ($7,000 − $3,000), is carried over to 2014. File a 1040x amended return If the Sampsons' capital loss had been $2,000, it would not have been more than the yearly limit. File a 1040x amended return Their capital loss deduction would have been $2,000. File a 1040x amended return They would have no carryover to 2014. File a 1040x amended return Short-term and long-term losses. File a 1040x amended return   When you carry over a loss, it retains its original character as either long term or short term. File a 1040x amended return A short-term loss you carry over to the next tax year is added to short-term losses occurring in that year. File a 1040x amended return A long-term loss you carry over to the next tax year is added to long-term losses occurring in that year. File a 1040x amended return A long-term capital loss you carry over to the next year reduces that year's long-term gains before its short-term gains. File a 1040x amended return   If you have both short-term and long-term losses, your short-term losses are used first against your allowable capital loss deduction. File a 1040x amended return If, after using your short-term losses, you have not reached the limit on the capital loss deduction, use your long-term losses until you reach the limit. File a 1040x amended return To figure your capital loss carryover from 2013 to 2014 use the Capital Loss Carryover Worksheet in the 2013 Instructions for Schedule D (Form 1040). File a 1040x amended return Joint and separate returns. File a 1040x amended return   On a joint return, the capital gains and losses of spouses are figured as the gains and losses of an individual. File a 1040x amended return If you are married and filing a separate return, your yearly capital loss deduction is limited to $1,500. File a 1040x amended return Neither you nor your spouse can deduct any part of the other's loss. File a 1040x amended return   If you and your spouse once filed separate returns and are now filing a joint return, combine your separate capital loss carryovers. File a 1040x amended return However, if you and your spouse once filed jointly and are now filing separately, any capital loss carryover from the joint return can be deducted only on the return of the spouse who actually had the loss. File a 1040x amended return Death of taxpayer. File a 1040x amended return   Capital losses cannot be carried over after a taxpayer's death. File a 1040x amended return They are deductible only on the final income tax return filed on the decedent's behalf. File a 1040x amended return The yearly limit discussed earlier still applies in this situation. File a 1040x amended return Even if the loss is greater than the limit, the decedent's estate cannot deduct the difference or carry it over to following years. File a 1040x amended return Corporations. File a 1040x amended return   A corporation can deduct capital losses only up to the amount of its capital gains. File a 1040x amended return In other words, if a corporation has a net capital loss, it cannot be deducted in the current tax year. File a 1040x amended return It must be carried to other tax years and deducted from capital gains occurring in those years. File a 1040x amended return For more information, see Publication 542. File a 1040x amended return Capital Gains Tax Rates The tax rates that apply to a net capital gain are generally lower than the tax rates that apply to other income. File a 1040x amended return These lower rates are called the maximum capital gains rates. File a 1040x amended return The term “net capital gain” means the amount by which your net long-term capital gain for the year is more than your net short-term capital loss. File a 1040x amended return For 2013, the maximum tax rates for individuals are 0%, 15%, 20%, 25%, and 28%. File a 1040x amended return Also, individuals, use the Qualified Dividends and Capital Gain Worksheet in the Instructions for Form 1040, or the Schedule D Tax Computation Worksheet in the Instructions for Schedule D (Form 1040) (whichever applies) to figure your tax if you have qualified dividends or net capital gain. File a 1040x amended return For more information, see chapter 4 of Publication 550. File a 1040x amended return Also see the Instructions for Schedule D (Form 1040). File a 1040x amended return Unrecaptured section 1250 gain. File a 1040x amended return   Generally, this is the part of any long-term capital gain on section 1250 property (real property) that is due to depreciation. File a 1040x amended return Unrecaptured section 1250 gain cannot be more than the net section 1231 gain or include any gain otherwise treated as ordinary income. File a 1040x amended return Use the worksheet in the Schedule D instructions to figure your unrecaptured section 1250 gain. File a 1040x amended return For more information about section 1250 property and net section 1231 gain, see chapter 3. File a 1040x amended return Form 4797 Use Form 4797 to report: The sale or exchange of: Property used in your trade or business; Depreciable and amortizable property; Oil, gas, geothermal, or other mineral properties; and Section 126 property. File a 1040x amended return The involuntary conversion (from other than casualty or theft) of property used in your trade or business and capital assets held in connection with a trade or business or a transaction entered into for profit. File a 1040x amended return The disposition of noncapital assets (other than inventory or property held primarily for sale to customers in the ordinary course of your trade or business). File a 1040x amended return The disposition of capital assets not reported on Schedule D. File a 1040x amended return The gain or loss (including any related recapture) for partners and S corporation shareholders from certain section 179 property dispositions by partnerships (other than electing large partnerships) and S corporations. File a 1040x amended return The computation of recapture amounts under sections 179 and 280F(b)(2) when the business use of section 179 or listed property decreases to 50% or less. File a 1040x amended return Gains or losses treated as ordinary gains or losses, if you are a trader in securities or commodities and made a mark-to-market election under Internal Revenue Code section 475(f). File a 1040x amended return You can use Form 4797 with Form 1040, 1065, 1120, or 1120S. File a 1040x amended return Section 1231 gains and losses. File a 1040x amended return   Show any section 1231 gains and losses in Part I. File a 1040x amended return Carry a net gain to Schedule D (Form 1040) as a long-term capital gain. File a 1040x amended return Carry a net loss to Part II of Form 4797 as an ordinary loss. File a 1040x amended return   If you had any nonrecaptured net section 1231 losses from the preceding 5 tax years, reduce your net gain by those losses and report the amount of the reduction as an ordinary gain in Part II. File a 1040x amended return Report any remaining gain on Schedule D (Form 1040). File a 1040x amended return See Section 1231 Gains and Losses in chapter 3. File a 1040x amended return Ordinary gains and losses. File a 1040x amended return   Show any ordinary gains and losses in Part II. File a 1040x amended return This includes a net loss or a recapture of losses from prior years figured in Part I of Form 4797. File a 1040x amended return It also includes ordinary gain figured in Part III. File a 1040x amended return Mark-to-market election. File a 1040x amended return   If you made a mark-to-market election, you should report all gains and losses from trading as ordinary gains and losses in Part II of Form 4797, instead of as capital gains and losses on Form 8949 and Schedule D (Form 1040). File a 1040x amended return See the Instructions for Form 4797. File a 1040x amended return Also see Special Rules for Traders in Securities, in chapter 4 of Publication 550. File a 1040x amended return Ordinary income from depreciation. File a 1040x amended return   Figure the ordinary income from depreciation on personal property and additional depreciation on real property (as discussed in chapter 3) in Part III. File a 1040x amended return Carry the ordinary income to Part II of Form 4797 as an ordinary gain. File a 1040x amended return Carry any remaining gain to Part I as section 1231 gain, unless it is from a casualty or theft. File a 1040x amended return Carry any remaining gain from a casualty or theft to Form 4684. File a 1040x amended return Prev  Up  Next   Home   More Online Publications
Español

Social Media Registry API Documentation

About the API

This documentation describes methods to use the Social Media Registry API to access the contents of the Social Media Registry.

The Social Media Registry is an official source of information about social media accounts that represent official U.S. federal government agencies, elected officials, or members of the President’s Cabinet.

If you work for the federal government and have a .gov or .mil e-mail address, you can register official U.S. federal accounts at HowTo.gov.

If you have feedback, questions, or want to tell us about the product you built with the Social Media Registry API, please e-mail us.

Back to Top

Accessing the API

The interface described here uses the same method URLs and parameters for all response formats, including HTML5, JSON, and XML. If no response format is specified at request time, the results are returned as HTML5 (with the assumption that a user is accessing the API via a web browser). To specify alternate formats, append the result format to the method call:

http://registry.usa.gov/accounts?agency_id=usda
http://registry.usa.gov/accounts.json?agency_id=usda
http://registry.usa.gov/accounts.xml?agency_id=usda

API requests can be called from remote sites via Javascript using the Cross-Origin Resource Sharing mechanism (CORS) supported in most browsers. All published API methods may be called from any domain.

If support for older browsers is required, JSON requests can be made with a callback parameter in order to return JSONP responses:

http://registry.usa.gov/accounts.json?agency_id=usda&callback=listaccounts

API Updates Using Feeds

Some API methods are also available as feeds in the ATOM format. These feeds can be added to any news feed reader to list recent changes.

The ATOM format is an XML feed standard; each entry contains a summary of the Registry change and a link to the Registry API to view more information.

Feed Examples

List the most recently updated official Twitter accounts: http://registry.usa.gov/accounts.atom?service_id=twitter

List the most recently updated official accounts from the U.S. Department of Agriculture: http://registry.usa.gov/accounts.atom?agency_id=usda

Back to Top

API Methods

/accounts (GET)

List official U.S. government social media accounts entries in the registry. This method is also available as an ATOM feed.

Parameters

  • agency_id: ID (from /agencies)
  • service_id: ID (from /services)
  • tag: text
  • page_size: integer
  • page_number: integer

Output

  • page_count: integer
  • page_number: integer
  • total_items: integer

Accounts

  • service_url: text
  • verified : boolean
  • service_id: ID
  • account: text
  • details_url: text
  • organization: text
  • agencies
    • agency_id: text
    • agency_name: text
    • agency_url: text

Example Calls

List all official accounts from the U.S. Department of Agriculture: http://registry.usa.gov/accounts?agency_id=usda

List all official Twitter accounts from the U.S. Department of Health and Human Services:
http://registry.usa.gov/accounts?service=twitter&agency_id=hhs

/accounts/{service ID} (GET)

A synonym for /accounts?service_id={service}, provided for REST-style browsing.

/accounts/{service ID}/{account} (GET)

A synonym for the /accounts/verify method, using a canonical service and account ID provided by that method. For example, the service and account ID for http://twitter.com/JPL_Bear might be twitter/JPL_Bear, making the canonical URL take the form http://registry.usa.gov/accounts/twitter/JPL_Bear

This is provided primarily for REST-style browsing.

Back to Top

/accounts/verify (GET)

Check whether the provided URL is registered as an official government social media account.

Example: /accounts/verify?service_url=https%3A%2F%2Ftwitter.com%2F%23%21%2FJPL_Bear

Parameters

  • service_url: URL (required)

Output

  • verified: boolean
  • service_url: URL
  • service_id: ID (from /services list)
  • account: text

(if verified is true:)

  • details_url: URL
  • organization: text
  • info_url: text
  • agencies
    • agency_id: text
    • agency_name: text
    • agency_url: text
  • tags: list
  • language: text
  • display_name: text
  • updated_by: text
  • updated_at: ISO 8601 date

Back to Top

/agencies (GET) 

List the sponsoring agencies that may be specified in the /accounts/add method.

Parameters

  • none

Output

  • page_count: integer
  • total_items: integer
  • page_number: integer
  • agencies: list
    • agency_id: text
    • agency_name: text
    • agency_url: text

/services (GET)

List the social media services that are currently supported in the /accounts/add method.

Parameters

  • none

Output

  • page_count: integer
  • total_items: integer
  • page_number: integer
  • services: list
    • service_id: text
    • service_name: text

Back to Top

/tags (GET) 

List tags that are suggested for describing an account.

Parameters

  • keywords: text

Output

  • tags: list
  • tag_id: text
  • tag_text: text

Source Code

The code for the Social Media Registry is open source and available on GitHub. It is written in Ruby.

Example Applications

Terms of Service

By using this data, you agree to the Terms of Service.

Back to Top

The File A 1040x Amended Return

File a 1040x amended return Publication 947 - Additional Material Prev  Up  Next   Home   More Online Publications