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

1040 Ez Forms Tax Return

How To Amend My 2011 Taxes2010 Federal Tax Form1040 Ez 2013Ez40File Only State Taxes2012 Tax Software FreeAmended Tax Return Instructions2012 Free Tax Return FilingTurbotax For Military Members Free2010 EfileFile State And Federal Taxes For FreeFederal Tax FormHow Amend A Tax ReturnWww Irs Gov Form1040x940 Tax Form 2012Form 1040nr SoftwareTax Cut Hr BlockHow To File A Amended Tax Return For 2010Filing 1040nr OnlineFree E File State And Federal TaxesIrs Gov Freefile ExtensionFree E File Federal And State Tax ReturnHow Do I Do An Amended Tax ReturnFree Tax Filing 2012Irs Gov FormsInstructions For 1040xIrs Form 48682009 Tax TablesUnemployed And TaxesHow To File Self Employed Taxes Step By Step2013 State Tax Forms2010 Tax Forms 1040ezH And R Block Free Online Tax FilingFree Sites For Filing State Income TaxesDownload A 1040ez Federal Tax FormIrs Free E File 2012Federal Tax 1040ezFree Tax Filing 20112011 Taxact OnlineFederal Tax Forms 1040x

1040 Ez Forms Tax Return

1040 ez forms tax return 6. 1040 ez forms tax return   Tax Treaty Benefits Table of Contents Topics - This chapter discusses: Useful Items - You may want to see: Purpose of Tax Treaties Common Benefits Competent Authority AssistanceAdditional filing. 1040 ez forms tax return Obtaining Copies of Tax Treaties Topics - This chapter discusses: Some common tax treaty benefits, How to get help in certain situations, and How to get copies of tax treaties. 1040 ez forms tax return Useful Items - You may want to see: Publication 597 Information on the United States—Canada Income Tax Treaty 901 U. 1040 ez forms tax return S. 1040 ez forms tax return Tax Treaties See chapter 7 for information about getting these publications. 1040 ez forms tax return Purpose of Tax Treaties The United States has tax treaties or conventions with many countries. 1040 ez forms tax return See Table 6-1 at the end of this chapter for a list of these countries. 1040 ez forms tax return Under these treaties and conventions, citizens and residents of the United States who are subject to taxes imposed by the foreign countries are entitled to certain credits, deductions, exemptions, and reductions in the rate of taxes of those foreign countries. 1040 ez forms tax return If a foreign country with which the United States has a treaty imposes a tax on you, you may be entitled to benefits under the treaty. 1040 ez forms tax return Treaty benefits generally are available to residents of the United States. 1040 ez forms tax return They generally are not available to U. 1040 ez forms tax return S. 1040 ez forms tax return citizens who do not reside in the United States. 1040 ez forms tax return However, certain treaty benefits and safeguards, such as the nondiscrimination provisions, are available to U. 1040 ez forms tax return S. 1040 ez forms tax return citizens residing in the treaty countries. 1040 ez forms tax return U. 1040 ez forms tax return S. 1040 ez forms tax return citizens residing in a foreign country also may be entitled to benefits under that country's tax treaties with third countries. 1040 ez forms tax return Certification of U. 1040 ez forms tax return S. 1040 ez forms tax return residency. 1040 ez forms tax return   Use Form 8802, Application for United States Residency Certification, to request certification of U. 1040 ez forms tax return S. 1040 ez forms tax return residency for purposes of claiming benefits under a tax treaty. 1040 ez forms tax return Certification can be requested for the current and any prior calendar years. 1040 ez forms tax return You should examine the specific treaty articles to find if you are entitled to a tax credit, tax exemption, reduced rate of tax, or other treaty benefit or safeguard. 1040 ez forms tax return Common Benefits Some common tax treaty benefits are explained below. 1040 ez forms tax return The credits, deductions, exemptions, reductions in rate, and other benefits provided by tax treaties are subject to conditions and various restrictions. 1040 ez forms tax return Benefits provided by certain treaties are not provided by others. 1040 ez forms tax return Personal service income. 1040 ez forms tax return If you are a U. 1040 ez forms tax return S. 1040 ez forms tax return resident who is in a treaty country for a limited number of days in the tax year and you meet certain other requirements, the payment you receive for personal services performed in that country may be exempt from that country's income tax. 1040 ez forms tax return Professors and teachers. 1040 ez forms tax return If you are a U. 1040 ez forms tax return S. 1040 ez forms tax return resident, the payment you receive for the first 2 or 3 years that you are teaching or doing research in a treaty country may be exempt from that country's income tax. 1040 ez forms tax return Students, trainees, and apprentices. 1040 ez forms tax return If you are a U. 1040 ez forms tax return S. 1040 ez forms tax return resident, amounts you receive from the United States for study, research, or business, professional and technical training may be exempt from a treaty country's income tax. 1040 ez forms tax return Some treaties exempt grants, allowances, and awards received from governmental and certain nonprofit organizations. 1040 ez forms tax return Also, under certain circumstances, a limited amount of pay received by students, trainees, and apprentices may be exempt from the income tax of many treaty countries. 1040 ez forms tax return Pensions and annuities. 1040 ez forms tax return If you are a U. 1040 ez forms tax return S. 1040 ez forms tax return resident, nongovernment pensions and annuities you receive may be exempt from the income tax of treaty countries. 1040 ez forms tax return Most treaties contain separate provisions for exempting government pensions and annuities from treaty country income tax, and some treaties provide exemption from the treaty country's income tax for social security payments. 1040 ez forms tax return Investment income. 1040 ez forms tax return If you are a U. 1040 ez forms tax return S. 1040 ez forms tax return resident, investment income, such as interest and dividends, that you receive from sources in a treaty country may be exempt from that country's income tax or taxed at a reduced rate. 1040 ez forms tax return Several treaties provide exemption for capital gains (other than from sales of real property in most cases) if specified requirements are met. 1040 ez forms tax return Tax credit provisions. 1040 ez forms tax return If you are a U. 1040 ez forms tax return S. 1040 ez forms tax return resident who receives income from or owns capital in a foreign country, you may be taxed on that income or capital by both the United States and the treaty country. 1040 ez forms tax return Most treaties allow you to take a credit against or deduction from the treaty country's taxes based on the U. 1040 ez forms tax return S. 1040 ez forms tax return tax on the income. 1040 ez forms tax return Nondiscrimination provisions. 1040 ez forms tax return Most U. 1040 ez forms tax return S. 1040 ez forms tax return tax treaties provide that the treaty country cannot discriminate by imposing more burdensome taxes on U. 1040 ez forms tax return S. 1040 ez forms tax return citizens who are residents of the treaty country than it imposes on its own citizens in the same circumstances. 1040 ez forms tax return Saving clauses. 1040 ez forms tax return U. 1040 ez forms tax return S. 1040 ez forms tax return treaties contain saving clauses that provide that the treaties do not affect the U. 1040 ez forms tax return S. 1040 ez forms tax return taxation of its own citizens and residents. 1040 ez forms tax return As a result, U. 1040 ez forms tax return S. 1040 ez forms tax return citizens and residents generally cannot use the treaty to reduce their U. 1040 ez forms tax return S. 1040 ez forms tax return tax liability. 1040 ez forms tax return However, most treaties provide exceptions to saving clauses that allow certain provisions of the treaty to be claimed by U. 1040 ez forms tax return S. 1040 ez forms tax return citizens or residents. 1040 ez forms tax return It is important that you examine the applicable saving clause to determine if an exception applies. 1040 ez forms tax return More information on treaties. 1040 ez forms tax return   Publication 901 contains an explanation of treaty provisions that apply to amounts received by teachers, students, workers, and government employees and pensioners who are alien nonresidents or residents of the United States. 1040 ez forms tax return Since treaty provisions generally are reciprocal, you usually can substitute “United States” for the name of the treaty country whenever it appears, and vice versa when “U. 1040 ez forms tax return S. 1040 ez forms tax return ” appears in the treaty exemption discussions in Publication 901. 1040 ez forms tax return   Publication 597 contains an explanation of a number of frequently-used provisions of the United States–Canada income tax treaty. 1040 ez forms tax return Competent Authority Assistance If you are a U. 1040 ez forms tax return S. 1040 ez forms tax return citizen or resident alien, you can request assistance from the U. 1040 ez forms tax return S. 1040 ez forms tax return competent authority if you think that the actions of the United States, a treaty country, or both, cause or will cause a tax situation not intended by the treaty between the two countries. 1040 ez forms tax return You should read any treaty articles, including the mutual agreement procedure article, that apply in your situation. 1040 ez forms tax return The U. 1040 ez forms tax return S. 1040 ez forms tax return competent authority cannot consider requests involving countries with which the United States does not have a tax treaty. 1040 ez forms tax return Effect of request for assistance. 1040 ez forms tax return   If your request provides a basis for competent authority assistance, the U. 1040 ez forms tax return S. 1040 ez forms tax return competent authority generally will consult with the treaty country competent authority on how to resolve the situation. 1040 ez forms tax return How to make your request. 1040 ez forms tax return   It is important that you make your request for competent authority consideration as soon as either of the following occurs. 1040 ez forms tax return You are denied treaty benefits. 1040 ez forms tax return Actions taken by both the United States and the foreign country result in double taxation or will result in taxation not intended by the treaty. 1040 ez forms tax return   In addition to making a request for assistance, you should take steps so that any agreement reached by the competent authorities is not barred by administrative, legal, or procedural barriers. 1040 ez forms tax return Some of the steps you should consider taking include the following. 1040 ez forms tax return Filing a protective claim for credit or refund of U. 1040 ez forms tax return S. 1040 ez forms tax return taxes. 1040 ez forms tax return Delaying the expiration of any period of limitations on the making of a refund or other tax adjustment. 1040 ez forms tax return Avoiding the lapse or termination of your right to appeal any tax determination. 1040 ez forms tax return Complying with all applicable procedures for invoking competent authority consideration. 1040 ez forms tax return Contesting an adjustment or seeking an appropriate correlative adjustment with respect to the U. 1040 ez forms tax return S. 1040 ez forms tax return or treaty country tax. 1040 ez forms tax return Taxpayers can consult with the U. 1040 ez forms tax return S. 1040 ez forms tax return competent authority to determine whether they need to take protective steps and when any required steps need to be taken. 1040 ez forms tax return   The request should contain all essential items of information, including the following items. 1040 ez forms tax return A reference to the treaty and the treaty provisions on which the request is based. 1040 ez forms tax return The years and amounts involved in both U. 1040 ez forms tax return S. 1040 ez forms tax return dollars and foreign currency. 1040 ez forms tax return A brief description of the issues for which competent authority assistance is requested. 1040 ez forms tax return   A complete listing of the information that must be included with the request can be found in Revenue Procedure 2006-54, or its successor. 1040 ez forms tax return Revenue Procedure 2006-54 is available at www. 1040 ez forms tax return irs. 1040 ez forms tax return gov/irb/2006-49_IRB/ar13. 1040 ez forms tax return html. 1040 ez forms tax return   Also, see Notice 2013-78, which provides proposed updates to the procedures for requesting U. 1040 ez forms tax return S. 1040 ez forms tax return competent authority assistance under tax treaties. 1040 ez forms tax return As noted, Revenue Procedure 2006-54 will be superseded by a revenue procedure to be published in the future. 1040 ez forms tax return    Your request for competent authority consideration should be addressed to:   Deputy Commissioner (International) Large Business and International Division Internal Revenue Service 1111 Constitution Avenue, NW Routing M4-365 Washington, DC 20224 Attn: TAIT Additional filing. 1040 ez forms tax return   In the case of U. 1040 ez forms tax return S. 1040 ez forms tax return - initiated adjustments, you also must file a copy of the request with the IRS office where your case is pending. 1040 ez forms tax return If the request is filed after the matter has been designated for litigation or while a suit contesting your relevant tax liability is pending in a United States court, a copy of the request, with a separate statement attached identifying the court where the suit is pending and the docket number of the action, also must be filed with the: Office of Associate Chief Counsel (International) Internal Revenue Service 1111 Constitution Avenue, NW Washington, DC 20224 Additional details on the procedures for requesting competent authority assistance are included in Revenue Procedure 2006-54, or its successor. 1040 ez forms tax return Obtaining Copies of Tax Treaties Table 6-1 lists those countries with which the United States has income tax treaties. 1040 ez forms tax return This table is updated through October 31, 2013. 1040 ez forms tax return You can get complete information about treaty provisions from the taxing authority in the country from which you receive income or from the treaty itself. 1040 ez forms tax return You can obtain the text of most U. 1040 ez forms tax return S. 1040 ez forms tax return treaties at IRS. 1040 ez forms tax return gov. 1040 ez forms tax return You also can request the text of treaties from the Department of Treasury at the following address. 1040 ez forms tax return Department of Treasury Office of Business and Public Liaison Rm. 1040 ez forms tax return 3411 1500 Pennsylvania Avenue, NW  Washington, DC 20220 If you have questions about a treaty and you are in the United States, Puerto Rico, or the U. 1040 ez forms tax return S. 1040 ez forms tax return Virgin Islands, you can call the IRS at 1-800-829-1040. 1040 ez forms tax return Table 6–1. 1040 ez forms tax return List of Tax Treaties (Updated through October 31, 2013) Country Official Text  Symbol1 General  Effective Date Citation Applicable Treasury Explanations  or Treasury Decision (T. 1040 ez forms tax return D. 1040 ez forms tax return ) Australia TIAS 10773 Dec. 1040 ez forms tax return 1, 1983 1986-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 220 1986-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 246 Protocol TIAS Jan. 1040 ez forms tax return 1, 2004     Austria TIAS Jan. 1040 ez forms tax return 1, 1999     Bangladesh TIAS Jan. 1040 ez forms tax return 1, 2007     Barbados TIAS 11090 Jan. 1040 ez forms tax return 1, 1984 1991-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 436 1991-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 466 Protocol TIAS Jan. 1040 ez forms tax return 1, 2005     Belgium TIAS Jan. 1040 ez forms tax return 1, 2008     Bulgaria TIAS Jan. 1040 ez forms tax return 1, 2009     Canada2 TIAS 11087 Jan. 1040 ez forms tax return 1, 1985 1986-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 258 1987-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 298 Protocol TIAS Jan. 1040 ez forms tax return 1, 2009     China, People's Republic of TIAS 12065 Jan. 1040 ez forms tax return 1, 1987 1988-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 414 1988-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 447 Commonwealth of Independent States3 TIAS 8225 Jan. 1040 ez forms tax return 1, 1976 1976-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 463 1976-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 475 Cyprus TIAS 10965 Jan. 1040 ez forms tax return 1, 1986 1989-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 280 1989-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 314 Czech Republic TIAS Jan. 1040 ez forms tax return 1, 1993     Denmark TIAS Jan. 1040 ez forms tax return 1, 2001     Protocol TIAS Jan. 1040 ez forms tax return 1, 2008     Egypt TIAS 10149 Jan. 1040 ez forms tax return 1, 1982 1982-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 219 1982-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 243 Estonia TIAS Jan. 1040 ez forms tax return 1, 2000     Finland TIAS 12101 Jan. 1040 ez forms tax return 1, 1991     Protocol TIAS Jan. 1040 ez forms tax return 1, 2008     France TIAS Jan. 1040 ez forms tax return 1, 1996     Protocol TIAS Jan. 1040 ez forms tax return 1, 2009     Germany TIAS Jan. 1040 ez forms tax return 1, 1990     Protocol TIAS Jan. 1040 ez forms tax return 1, 2008     Greece TIAS 2902 Jan. 1040 ez forms tax return 1, 1953 1958-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 1054 T. 1040 ez forms tax return D. 1040 ez forms tax return 6109, 1954-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 638 Hungary TIAS 9560 Jan. 1040 ez forms tax return 1, 1980 1980-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 333 1980-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 354 Iceland TIAS 8151 Jan. 1040 ez forms tax return 1, 2009     India TIAS Jan. 1040 ez forms tax return 1, 1991     Indonesia TIAS 11593 Jan. 1040 ez forms tax return 1, 1990     Ireland TIAS Jan. 1040 ez forms tax return 1, 1998     Israel TIAS Jan. 1040 ez forms tax return 1, 1995     Italy TIAS Jan. 1040 ez forms tax return 1, 2010     Jamaica TIAS 10207 Jan. 1040 ez forms tax return 1, 1982 1982-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 257 1982-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 291 Japan TIAS Jan. 1040 ez forms tax return 1, 2005     Kazakhstan TIAS Jan. 1040 ez forms tax return 1, 1996     Korea, South TIAS 9506 Jan. 1040 ez forms tax return 1, 1980 1979-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 435 1979-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 458 Latvia TIAS Jan. 1040 ez forms tax return 1, 2000     Lithuania TIAS Jan. 1040 ez forms tax return 1, 2000     Luxembourg TIAS Jan. 1040 ez forms tax return 1, 2001     Malta TIAS Jan. 1040 ez forms tax return 1, 2011     Mexico TIAS Jan. 1040 ez forms tax return 1,1994     Protocol TIAS Jan. 1040 ez forms tax return 1, 2004               Table 6–1 (continued). 1040 ez forms tax return Country Official Text  Symbol1 General  Effective Date Citation Applicable Treasury Explanations  or Treasury Decision (T. 1040 ez forms tax return D. 1040 ez forms tax return ) Morocco TIAS 10195 Jan. 1040 ez forms tax return 1, 1981 1982-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 405 1982-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 427 Netherlands TIAS Jan. 1040 ez forms tax return 1, 1994     Protocol TIAS Jan. 1040 ez forms tax return 1, 2005     New Zealand TIAS 10772 Nov. 1040 ez forms tax return 2, 1983 1990-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 274 1990-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 303 Protocol TIAS Jan. 1040 ez forms tax return 1, 2011     Norway TIAS 7474 Jan. 1040 ez forms tax return 1, 1971 1973-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 669 1973-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 693 Protocol TIAS 10205 Jan. 1040 ez forms tax return 1, 1982 1982-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 440 1982-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 454 Pakistan TIAS 4232 Jan. 1040 ez forms tax return 1, 1959 1960-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 646 T. 1040 ez forms tax return D. 1040 ez forms tax return 6431, 1960-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 755 Philippines TIAS 10417 Jan. 1040 ez forms tax return 1, 1983 1984-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 384 1984-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 412 Poland TIAS 8486 Jan. 1040 ez forms tax return 1, 1974 1977-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 416 1977-1 C. 1040 ez forms tax return B. 1040 ez forms tax return 427 Portugal TIAS Jan. 1040 ez forms tax return 1, 1996     Romania TIAS 8228 Jan. 1040 ez forms tax return 1, 1974 1976-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 492 1976-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 504 Russia TIAS Jan. 1040 ez forms tax return 1, 1994     Slovak Republic TIAS Jan. 1040 ez forms tax return 1, 1993     Slovenia TIAS Jan. 1040 ez forms tax return 1, 2002     South Africa TIAS Jan. 1040 ez forms tax return 1, 1998     Spain TIAS Jan. 1040 ez forms tax return 1, 1991     Sri Lanka TIAS Jan. 1040 ez forms tax return 1, 2004     Sweden TIAS Jan. 1040 ez forms tax return 1, 1996     Protocol TIAS Jan. 1040 ez forms tax return 1, 2007     Switzerland TIAS Jan. 1040 ez forms tax return 1, 1998     Thailand TIAS Jan. 1040 ez forms tax return 1, 1998     Trinidad and Tobago TIAS 7047 Jan. 1040 ez forms tax return 1, 1970 1971-2 C. 1040 ez forms tax return B. 1040 ez forms tax return 479   Tunisia TIAS Jan. 1040 ez forms tax return 1, 1990     Turkey TIAS Jan. 1040 ez forms tax return 1, 1998     Ukraine TIAS Jan. 1040 ez forms tax return 1, 2001     United Kingdom TIAS Jan. 1040 ez forms tax return 1, 2004     Venezuela TIAS Jan. 1040 ez forms tax return 1, 2000      1(TIAS) — Treaties and Other International Act Series. 1040 ez forms tax return  2Information on the treaty can be found in Publication 597, Information on the United States—Canada Income Tax Treaty. 1040 ez forms tax return 3The U. 1040 ez forms tax return S. 1040 ez forms tax return -U. 1040 ez forms tax return S. 1040 ez forms tax return S. 1040 ez forms tax return R. 1040 ez forms tax return income tax treaty applies to the countries of Armenia, Azerbaijan, Belarus, Georgia, Kyrgyzstan, Moldova, Tajikistan, Turkmenistan, and Uzbekistan. 1040 ez forms tax 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 1040 Ez Forms Tax Return

1040 ez forms tax return Publication 535 - Additional Material Prev  Up  Next   Home   More Online Publications