Annual Production Figures of United States Currency (1980-2012)

Provided by the Bureau of Engraving and Printing (BEP), a bureau of the U.S. Department of the Treasury, this dataset details the number of $1, $2, $5, $10, $20, $50, and $100 notes printed each year by the bureau.

Getting Started

All communication with the API is done through HTTPS, and errors are communicated through HTTP response codes. Available response types include JSON, XML, and CSV, which are selectable by the "extension" on API requests or by HTTP Accepts headers.

This documentation also includes inline, runable examples. Click on any link that contains a gear symbol next to it to run that example live against the Annual Production Figures of United States Currency (1980-2012) API.

App Tokens

All requests should include an app token that identifies your application, and each application should have its own unique app token. A limited number of requests can be made without an app token, but they are subject to much lower throttling limits than request that do include one. If you don't have an app token yet, click the button to the right to sign up for one.

Once you have an app token, you can include it with your request either by using the X-App-Token HTTP header, or by passing it via the $app_token parameter on your URL.

Response Codes

One of the following response codes will be returned with every request:

  1. 200Successful request.
  2. 202Request processing. You can retry your request, and when it's complete, you'll get a 200 instead.
  3. 400Bad request
  4. 401Unauthorized. You're not authorized to access this resource.
  5. 404Not found. The resource requested doesn't exist.
  6. 429Too Many Requests. The client has made too many requests and is currently being rate limited.
  7. 500Server errors. Our bad!

Code Samples

#!/usr/bin/env ruby

require 'net/https'
uri = URI('https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?recall_id=94')

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER

request = Net::HTTP::Get.new(uri.request_uri)
request.add_field('X-App-Token', ARGV[0])

response = http.request(request)
puts response.code
puts response.body
#!/usr/bin/env python

import sys
import requests

r = requests.get('https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?recall_id=94', headers={'X-App-Token': sys.argv[1]})
print r.status_code
print r.text
request = require 'request'
options = uri: 'https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?$$app_token=APP_TOKEN&recall_id=94'
request options, (err, response, body) ->  console.log body
#!/bin/sh 

curl --header "X-App-Token: $1" "https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?recall_id=94"

Fields

The following fields are available on the Annual Production Figures of United States Currency (1980-2012) API.

fiscal_year

Human Name: Fiscal Year
Type: text

Examples

Retrieve all records with fiscal_year equal to FY 2012:

Retrieve all records where fiscal_year is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?$where=within_circle(fiscal_year, 47.598177,-122.33448, 1000)

_1_bills

Human Name: $1 Bills
Type: text
The number of $1 bills printed.

Examples

Retrieve all records with _1_bills equal to 5,190,400,000:

Retrieve all records where _1_bills is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?$where=within_circle(_1_bills, 47.598177,-122.33448, 1000)

_2_bills

Human Name: $2 Bills
Type: text
The number of $2 bills printed.

Examples

Retrieve all records with _2_bills equal to  N/A:

Retrieve all records where _2_bills is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?$where=within_circle(_2_bills, 47.598177,-122.33448, 1000)

_5_bills

Human Name: $5 Bills
Type: text
The number of $5 bills printed.

Examples

Retrieve all records with _5_bills equal to 992,000,000:

Retrieve all records where _5_bills is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?$where=within_circle(_5_bills, 47.598177,-122.33448, 1000)

_10_bills

Human Name: $10 Bills
Type: text
The number of $10 bills printed.

Examples

Retrieve all records with _10_bills equal to N/A:

Retrieve all records where _10_bills is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?$where=within_circle(_10_bills, 47.598177,-122.33448, 1000)

_20_bills

Human Name: $20 Bills
Type: text
The number of $20 bills printed.

Examples

Retrieve all records with _20_bills equal to 994,560,000:

Retrieve all records where _20_bills is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?$where=within_circle(_20_bills, 47.598177,-122.33448, 1000)

_50_bills

Human Name: $50 Bills
Type: text
The number of $50 bills printed.

Examples

Retrieve all records with _50_bills equal to N/A:

Retrieve all records where _50_bills is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?$where=within_circle(_50_bills, 47.598177,-122.33448, 1000)

_100_bills

Human Name: $100 Bills
Type: text
The number of $100 bills printed.

Examples

Retrieve all records with _100_bills equal to N/A:

Retrieve all records where _100_bills is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://explore.data.gov/resource/annual-production-figures-of-united-states-currency.json?$where=within_circle(_100_bills, 47.598177,-122.33448, 1000)