CARO by Spherity Documentation

CARO Documentation #

General Introduction #

CARO supports trading partners using a Verification Routing Service (VRS) for Product Verifications to comply with U.S. Drug Supply Chain Security Act (DSCSA) requirements for Authorized Trading Partners (ATP). To increase patient safety, the DSCSA postulates that pharmaceutical supply chain actors are only permitted to interact with trading partners that are authorized. Manufacturers and repackagers are authorized when they hold a valid FDA registration; wholesalers, third-party logistics providers (3PL), and dispensers require a State-issued license (refer to FDA guidance). Watch this FDA video for an introduction to the topic.

An ATP check on both sides is, for example, required for the verification of saleable returns or suspicious products. A wholesaler or dispenser would use their VRS to route the verification request to the original manufacturer. The manufacturer needs to identify the requester and verify the ATP status before sending a response with the product details. The identification and verification of the authorized status is also required when the requester receives a response from the manufacturer. Hence, both the requester and responder need mechanisms in place to ensure that the other side is an ATP.

How this documentation is organized #

The CARO API has a lot of documentation. A high-level overview of how it’s organized will help you know where to look for what you need:

  • Tutorials take you through a series of steps to complete a whole process. Start here if you’re new to CARO.
  • API documentation contains technical references for APIs and other aspects of CARO. They describe how it works and how to use it, but assume that you have a basic understanding of key concepts like REST, JSON and Http.

Find support documentation

First steps for technical implementers #

  1. Explore some of our CARO endpoints, such as Verifiable presentation generation
  2. Take a look at our tutorial for VRS providers: VRS Testing Guide
  3. Start implementing our API from scratch: Authentication | Errors

Getting help #

If you have already been invited to a dedicated Spherity Slack support channel, seeking assistance there will be the most straight-forward way for you to reach the CARO support team.

Otherwise please contact for product-related questions or for technical queries.

Support hours are Monday – Friday 8:00 AM to 5:00 PM (EST).