> ## Documentation Index
> Fetch the complete documentation index at: https://developer.worldly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Base URLs & Environments

> API base URLs for the Worldly production and demo environments.

Worldly provides two environments for API access: **production** and **demo**. Both environments use the same authentication mechanism and API surface, but serve different purposes.

## Environments

<CardGroup cols={2}>
  <Card title="Production" icon="server">
    Live environment with real data. Use this for all production integrations.

    ```
    https://api-v2.production.higg.org
    ```
  </Card>

  <Card title="Demo" icon="flask">
    Sandbox environment for testing and development. Use this to build and validate your integration before going live.

    ```
    https://api-v2.demo.higg.org
    ```
  </Card>
</CardGroup>

## Base URLs by API

Each API group uses a path prefix on top of the environment host. Some groups (such as Module Data and Bulk CSV) share the same base path because they belong to the same underlying service. The table below lists the full base URL for every API in both environments.

| API                     | Production                                                       | Demo                                                       |
| ----------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------- |
| **Module Data**         | `https://api-v2.production.higg.org/api/v1/moduledata`           | `https://api-v2.demo.higg.org/api/v1/moduledata`           |
| **Bulk CSV**            | `https://api-v2.production.higg.org/api/v1/modulecsv`            | `https://api-v2.demo.higg.org/api/v1/modulecsv`            |
| **Performance CSV**     | `https://api-v2.production.higg.org/api/v1/moduleperformancecsv` | `https://api-v2.demo.higg.org/api/v1/moduleperformancecsv` |
| **File Data**           | `https://api-v2.production.higg.org/api/v1/filedata`             | `https://api-v2.demo.higg.org/api/v1/filedata`             |
| **Module Last Updated** | `https://api-v2.production.higg.org/api/v1/modulelastupdated`    | `https://api-v2.demo.higg.org/api/v1/modulelastupdated`    |
| **Module Shares**       | `https://api-v2.production.higg.org/api/v1/moduleshares`         | `https://api-v2.demo.higg.org/api/v1/moduleshares`         |
| **PIC**                 | `https://api-v2.production.higg.org/pic-api/v1`                  | `https://api-v2.demo.higg.org/pic-api/v1`                  |
| **MSI**                 | `https://api-v2.production.higg.org/msi-api/v1`                  | `https://api-v2.demo.higg.org/msi-api/v1`                  |
| **Product Module**      | `https://api-v2.production.higg.org/pm-api/v1/product`           | `https://api-v2.demo.higg.org/pm-api/v1/product`           |

## Using the demo environment

The demo environment is available for all API customers to test their integrations. To use it, replace `production` with `demo` in any base URL.

<Steps>
  <Step title="Get demo credentials">
    Request demo environment API credentials from your Worldly account team. Demo credentials are separate from production credentials.
  </Step>

  <Step title="Update your base URL">
    Replace `api-v2.production.higg.org` with `api-v2.demo.higg.org` in your API requests.
  </Step>

  <Step title="Test your integration">
    Run your integration against the demo environment to validate request/response handling, error handling, and data parsing.
  </Step>

  <Step title="Switch to production">
    Once validated, swap the base URL back to `api-v2.production.higg.org` and use your production credentials.
  </Step>
</Steps>

<Note>
  The API playground on each endpoint page includes an environment selector that lets you toggle between production and demo base URLs.
</Note>

<Warning>
  Demo environment data is synthetic and may be reset periodically. Do not use it for production workloads.
</Warning>