API
Checking Raims account

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

ArtifactWhen to use itWhat happens when you update it
openapi.spec3.json or openapi.spec3.yamlImport the reference or provide input to a generator.A new download retrieves the currently published contract.
Client in ./generated/raimsMake 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 credentialAuthenticate calls made by the tool or application.Configure it separately; the contract contains no keys.
  1. Download the contract

    Use one of the files below. JSON and YAML describe the same endpoints.

  2. Import or generate

    Import the URL into your tool or use the local file as generator input. In this page's command, replace YOUR_GENERATOR with your language's option.

  3. 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:

Shell
curl --fail --location --output openapi.spec3.json https://cdn.raims.com/downloads/openapi/latest/openapi.spec3.json

In 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:

Shell
openapi-generator-cli generate \
  -i openapi.spec3.json \
  -g YOUR_GENERATOR \
  -o ./generated/raims

Choose 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.