About the API
In 2014, We the People officially launched a "write" version of the Petitions Application Programming Interface, or "API."Using our API, you can bring We the People petitions to third-party platforms (including other petition services, personal blogs, and websites) in order to spread the word and help gather even more signatures. Any signatures collected this way, once validated, will count towards the signature threshold needed for a petition to receive an official White House response. Think of our API as a valuable tool for building community support around an initiative -- it can help get a petition in front of more eyes, more quickly, with exciting results.
Contact us if you have any questions about the API.
Need a place to test out the API? Start with the Sandbox! This environment exists for developers to experiment with building out a new API integration or visualization. Go ahead, play around without worrying about production errors.
There are four petitions with a static expiration date - you can build a form that will submit test signatures to one of those petitions using the API. If your code is correct, you will be able to submit signatures using the API base URL and receive the expected acceptance response back from the API.
Please note: Petitions on the Sandbox site are NOT submitted to the We the People platform. They will not get Administration responses, no matter how many signatures they garner.
There are some basic terms that developers and their users will need to follow. We have tried to make these rules as straightforward as possible, but if you have questions or comments, you can write to us here.
Developers leveraging the We the People write-API for a tool, service, or application ("app") must present the following notice to users before a user submits a signature through the API: "This app uses the We the People API, but is neither endorsed nor certified by the White House." You may use White House and We the People names and logos to identify the source of API content; you may not, however, use White House or We the People names and logos in any other way, including in a manner that conveys the false impression that the White House has endorsed any message, product, service, or entity (not-for-profit, commercial or otherwise).
Permissible Use and Right to Limit
You may use the We the People API's read methods to develop apps to search, display, analyze, retrieve, view, and otherwise acquire information from We the People data, subject to the parameters set forth in this Agreement. You may also use the API's write methods to submit signatures to WhiteHouse.gov in order to promote specific We the People petitions and reach the required signature threshold for a response.
Use of the API's write methods requires that a key be submitted when those methods are called. To request a key for the write-API, click here.
Developers and users leveraging the We the People API should be mindful of maintaining the integrity of the petitions process, as well as the stability of We the People and their own applications. Individual users issuing requests in excess of current threshold levels may experience degraded performance and may be blocked entirely. Please review the API documentation for more details including current usage thresholds.
- Threats of unlawful violence or harm to any individual or group;
- Obscene, vulgar, or lewd material;
- Defamatory or fraudulent statements;
- Terms commonly understood to constitute profanity or abusive or degrading slurs or epithets;
- Information invading an individual's privacy; or
- Information that if published would violate criminal law or give rise to civil liability.
In connection with your use of the API on your website, you may not make false representations with respect to data obtained or submitted through this API, including:
- Representing that a petition or any other content generated using the We the People API was authored or endorsed by the White House, the President, his staff or his Administration, including for the purpose of fundraising.
- Using the We the People API in order to gather email addresses or other data under false pretenses, including under the pretense of participating in We the People, without intending to submit such information through the write-API;
- Falsely attributing signature data being submitted through the write-API; or
- Misleading users about the content or status of a We the People petition in order to obtain their signatures.
Right to Limit and Access Termination
In order to ensure the security and stability of the We the People API, to promote equal access to all users, to prevent abuse, and to enhance compliance with the We the People Agreements, use of the API is subject to certain limitations on access, calls, and use as set forth in this Agreement and the API documentation. Access determinations will be made pursuant to the guidelines set forth in the Agreements, without regard to viewpoint or organizational affiliation.
If the White House or We the People administrators reasonably believe that you have violated or attempted to violate the Agreements, the White House may temporarily or permanently revoke your access to the write-API by deactivating your API key, disabling your We the People user account, removing any petition you have created, or removing your signature from any petition created by another user. The White House may also block access from IP addresses, keys, or other identifying traits that it has reasonable belief are using automated systems or bulk processes to create petition signatures.
If your access to the API is revoked, you may contact the White House for additional information or reconsideration of this determination. Termination of use or access to the We the People API in no way precludes your organization or petition signatories from contacting the White House. You may still access or create and sign petitions on We the People via https://petitions.whitehouse.gov; you may submit comments or questions to the White House here; or you may contact the White House through other means of communication.
Data submitted through the We the People API is subject to the Presidential Records Act and may be archived.
Other Terms and Conditions