OpenAPI contract
Download or import the public Raims API contract.
The raimshq/openapi repository publishes the OpenAPI contract for the Raims API version available to integrations. Use this contract to inspect endpoint structures, import the reference into a compatible tool or generate a client for your project.
The latest directory tracks the API version that is actually published. It
does not include changes that exist only in source code.
Choose the file for each step
| Artifact | When to use it | What happens when you update it |
|---|---|---|
openapi.spec3.json or openapi.spec3.yaml | Import the reference or provide input to a generator. | A new download retrieves the currently published contract. |
Client in ./generated/raims | Make calls through the generated library in your project. | Run the generator again and review the code; downloading the contract alone does not change this directory. |
| Integration credential | Authenticate calls made by the tool or application. | Configure it separately; the contract contains no keys. |
Download the contract
Use one of the files below. JSON and YAML describe the same endpoints.
Import or generate
Import the URL into your tool or use the local file as generator input. In this page's command, replace
YOUR_GENERATORwith your language's option.Check the integration
Review the generated code changes and test with Sandbox before updating the application. Start with your first query.
Available files
Both files describe the same contract. Choose the format accepted by your tool.
Download or import
To download the JSON file:
curl --fail --location --output openapi.spec3.json https://cdn.raims.com/downloads/openapi/latest/openapi.spec3.jsonIn Postman, Insomnia or another OpenAPI 3 compatible tool, choose the option to import from a URL and enter the JSON or YAML address. If the tool accepts only local files, download either format and import it from disk.
The contract describes Bearer authentication but contains no credentials. Configure your key in the tool's secure environment and do not save it in an exported collection.
Generate a client
Use the downloaded file as input for an OpenAPI 3 compatible generator. For example, with the OpenAPI Generator CLI:
openapi-generator-cli generate \
-i openapi.spec3.json \
-g YOUR_GENERATOR \
-o ./generated/raimsChoose the generator for the language and library used by your project. Review the generated code, keep the generator configuration under version control and run your integration tests before updating your application. This client belongs to your project and is not an official Raims SDK.
Keep the contract up to date
Use the addresses on this page to download the current contract, including for code generation and CI. Download the file again before generating the client to follow the published API version.
Review the contract diff, regenerate the client and run your integration tests before updating your application. Downloading a new contract does not automatically change code already generated in your project.