Welcome to the Product Code Builder (PCB) API Usage Documentation page. The documentation provides information regarding how the API retrieves the FDA product code information based upon the code portions selected for each of the five components (Industry, Class, Subclass, PIC, and Group) using the various REST Endpoints. REST endpoints provide a ‘RESTful’ web service that generates an action to retrieve or act upon a specific piece of information that resides in a database.
To use the API REST Endpoints, enter the Authorization-User and Authorization-Key by clicking the button at the top. Please submit authorization key requests using the online API Key Request Form. Please include the e-mail address that you would like to be used as the user name of the authorization key, your name, and the firm name.
Each REST Endpoint is documented below and allows users that have entered the Authorization-User and Authorization-Key on this page to see how the request URL is constructed for each REST Endpoint and what each returns. When developing a method to utilize this API not using this page, below are some points that may help explain why results are not being returned as expected:
For requests for assistance regarding the PCB API, please e-mail ORAAPIRequests@fda.hhs.gov.
Following is an example of the PCB API REST Endpoint. In the below list of REST Endpoints, you will need to click on the REST Endpoint title to expand the window.
Upon clicking, the REST Endpoints display the six sections including Implementation Notes, Response Class, Parameters, Response Messages, Request URL, and Response Body. Please note that the GET/industry endpoint does not display the Parameters section.
Implementation Notes - Gives a brief description of what data is accessed and displayed
Response Class - Indicates the response class description of the API.
Parameters - Allows entering query parameters for the endpoint in the text box.
Response Messages - Is a legend that shows the API return codes and their meaning.
Request URL - Shows the URL of the requested API path.
Response Body - Shows the response of the API request.
Finally, notice the Try it out! button. Once you enter a specific value for the selected REST Endpoint in the Parameters field, click the Try it out! button. The results are displayed in the Response Body window.