Name: FormulationCheck API
Brand: nicheapi-llc-1
SKU: api-nicheapi-llc-1-formulationcheck
Availability: InStock
Author: API Market

True Scary Stories

# FormulationCheck API

## Overview
The FormulationCheck API is a cross-border regulatory compliance engine purpose-built for beauty, personal care, and supplement formulations. Submit a product formula and receive a jurisdiction-by-jurisdiction compliance report covering banned ingredients, concentration limit violations, required label claims, and prohibited claims — all referenced against real CAS numbers and authoritative citations including EU CosIng Annexes, 21 CFR, and Health Canada Hotlist entries. The API covers 62 regulated ingredients across 7 jurisdictions: US FDA, EU CosIng, Health Canada, KFDA/MFDS (South Korea), ASEAN, ANVISA (Brazil), and GSO/GCC (Gulf States). Batch analysis supports up to 100 formulas per request, making it suited for contract manufacturers, regulatory affairs software vendors, and e-commerce compliance teams operating at scale.

## Features

*   **Full Cross-Jurisdiction Compliance Analysis**: A single POST call checks a formula against all 7 supported jurisdictions — or a selected subset — returning per-jurisdiction pass/fail status, banned ingredient flags, concentration limit violations, and labeling requirements.
*   **62 Regulated Ingredients**: Covers preservatives, UV filters, vitamins (including retinol and its derivatives), parabens, formaldehyde-releasers, and other major regulated categories, each with real CAS numbers and regulatory citations.
*   **Concentration Limit Enforcement**: Product-type-specific limits (leave-on vs. rinse-off) enforced per jurisdiction, with exact limit values and source references returned in violations.
*   **Banned Substance Detection**: Jurisdiction-specific bans flagged with the exact regulatory citation (e.g., EU CosIng Annex II entry, FDA prohibited ingredient ruling).
*   **Label Claims Intelligence**: Required claims (e.g., vitamin A content warnings, sunscreen SPF disclaimers, allergen declarations) and prohibited claims (e.g., jurisdiction-specific restrictions on "hypoallergenic" or therapeutic language) returned per formula analysis.
*   **7 Jurisdictions Covered**: US FDA, EU CosIng, Health Canada, KFDA/MFDS (South Korea), ASEAN, ANVISA (Brazil), and GSO/GCC (Gulf States).
*   **Ingredient Reference Library**: Full regulatory profile for each of the 62 regulated ingredients, including concentration limits, banned-in status, labeling requirements, and source citations — accessible via dedicated GET endpoints with search and filtering.
*   **Batch Processing**: Analyze up to 100 formulas in a single request for high-volume workflows.
*   **Test Scenarios**: Predefined test formulas available via the test endpoint for validating compliance rules and exploring the response schema.

## Use Cases

The FormulationCheck API is suited for a range of compliance, manufacturing, and regulatory technology workflows:

*   **Beauty Brands**: Validate a new formula across all target markets before launch — identifying banned ingredients, concentration violations, and required label claims in a single call rather than through separate manual reviews per jurisdiction.
*   **Supplement Companies**: Navigate the regulatory gap between FDA DSHEA compliance, EU Novel Foods regulations, Health Canada Natural Product Number requirements, and ASEAN restrictions with a unified, programmatic compliance check.
*   **Contract Manufacturers**: Replace multi-jurisdiction compliance spreadsheets with a single API call per formula. Validate any private-label product for any market without maintaining separate regulatory databases per jurisdiction.
*   **Amazon & Shopify Compliance Teams**: Automate pre-listing compliance checks for third-party seller formulas. Flag banned or non-compliant products before they reach warehouse intake.
*   **Regulatory Affairs Software Vendors**: Embed cross-jurisdiction ingredient intelligence into compliance dashboards and RegTech platforms without building or maintaining a proprietary ingredient database.


## API Documentation

### Base URL
All API requests for the FormulationCheck API should be made to the following base URL:
`https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck`

### Authentication
Authentication is handled via an API key obtained from RapidAPI. Include your key in the `x-api-market-key` header of every request:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key from RapidAPI.


### Endpoints

#### 1. Analyze a Formula

Submit a product formula for full cross-jurisdiction compliance analysis. Returns per-jurisdiction compliance status, banned ingredient flags, concentration limit violations, required label claims, and prohibited claims.

**Method**: `POST`
**Endpoint**: `/formulationcheck/analyze`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `product_name` | body | Name of the product being analyzed | `string` | No |
| `ingredients` | body | Array of ingredient objects, each containing `name`, `cas_number`, and `concentration_percent` | `array` | Yes |
| `ingredients[].name` | body | Common or INCI name of the ingredient | `string` | Yes |
| `ingredients[].cas_number` | body | CAS Registry Number for the ingredient | `string` | No |
| `ingredients[].concentration_percent` | body | Concentration of the ingredient as a percentage of the total formula | `number` | No |
| `jurisdictions` | body | Optional array of jurisdiction codes to limit analysis scope (e.g., `["US","EU","CA"]`). Omit to check all 7 jurisdictions. | `array` | No |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/analyze" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_name": "HydraGlow Day Cream SPF 30",
    "ingredients": [
      {"name": "Retinol", "cas_number": "68-26-8", "concentration_percent": 0.3},
      {"name": "Titanium Dioxide", "cas_number": "13463-67-7", "concentration_percent": 5.0}
    ]
  }'
```

**Example Response (200 OK)**:

```json
{
  "product_name": "HydraGlow Day Cream SPF 30",
  "jurisdictions_checked": ["US", "EU", "CA", "KR", "ASEAN", "BR", "GCC"],
  "overall_status": "non_compliant",
  "results": [
    {
      "jurisdiction": "EU",
      "jurisdiction_name": "EU CosIng",
      "status": "non_compliant",
      "violations": [
        {
          "ingredient": "Retinol",
          "cas_number": "68-26-8",
          "violation_type": "concentration_limit",
          "submitted_concentration": 0.3,
          "max_allowed": 0.05,
          "product_type": "leave-on",
          "citation": "EU CosIng Annex III, Entry 374",
          "severity": "high"
        }
      ],
      "required_claims": [
        "Contains Retinol — not recommended for use around the eye contour area"
      ],
      "prohibited_claims": []
    },
    {
      "jurisdiction": "US",
      "jurisdiction_name": "US FDA",
      "status": "compliant",
      "violations": [],
      "required_claims": [
        "Sunscreen — see Drug Facts panel"
      ],
      "prohibited_claims": []
    }
  ],
  "banned_ingredients": [],
  "total_violations": 1
}
```

#### 2. Batch Analyze Formulas

Analyze up to 100 product formulas in a single request.

**Method**: `POST`
**Endpoint**: `/formulationcheck/analyze/batch`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `formulas` | body | Array of formula objects, each following the same structure as the `/analyze` request body (max 100) | `array` | Yes |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/analyze/batch" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "formulas": [
      {
        "product_name": "HydraGlow Day Cream SPF 30",
        "ingredients": [
          {"name": "Retinol", "cas_number": "68-26-8", "concentration_percent": 0.3}
        ]
      },
      {
        "product_name": "NightRepair Serum",
        "ingredients": [
          {"name": "Niacinamide", "cas_number": "98-92-0", "concentration_percent": 5.0}
        ]
      }
    ]
  }'
```

#### 3. Run Test Scenarios

Run predefined test formulas to validate compliance rules and explore the full response schema without submitting real formula data.

**Method**: `POST`
**Endpoint**: `/formulationcheck/test`

**Request Body**:

| Name | In | Description | Type | Required | Default |
| :--- | :--- | :--- | :--- | :--- | :--- |
| `count` | body | Number of predefined test scenarios to run | `integer` | No | `1` |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/test" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 3}'
```

#### 4. List Regulated Ingredients

Retrieve a paginated list of all 62 regulated ingredients with filtering by category, jurisdiction, name, or CAS number.

**Method**: `GET`
**Endpoint**: `/formulationcheck/ingredients`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter ingredients by name or CAS number | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/ingredients?q=retinol&limit=10" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 5. Get Ingredient by ID

Retrieve the full regulatory profile for a specific ingredient — including concentration limits per jurisdiction, banned-in status, labeling requirements, and source citations.

**Method**: `GET`
**Endpoint**: `/formulationcheck/ingredients/{id}`

**Parameters**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `id` | path | Unique identifier for the ingredient record | `string` | Yes |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/ingredients/ING-0012" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 6. List Jurisdictions

Retrieve all 7 supported jurisdictions with metadata including regulatory authority, region, and coverage notes.

**Method**: `GET`
**Endpoint**: `/formulationcheck/jurisdictions`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/jurisdictions" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 7. List Banned Substances

Retrieve a paginated list of banned substance records with jurisdiction-specific citations.

**Method**: `GET`
**Endpoint**: `/formulationcheck/banned`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter banned substances by keyword or CAS number | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/banned?q=formaldehyde&limit=10" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 8. List Concentration Limits

Retrieve concentration limit tables with optional filtering by ingredient or jurisdiction.

**Method**: `GET`
**Endpoint**: `/formulationcheck/limits`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter concentration limit records by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/limits?q=parabens&limit=10" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 9. List Required Label Claims

Retrieve required label claims across jurisdictions — including sunscreen SPF disclaimers, vitamin A content warnings, and allergen declarations.

**Method**: `GET`
**Endpoint**: `/formulationcheck/claims/required`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter required claims by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/claims/required?q=retinol" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 10. List Prohibited Label Claims

Retrieve prohibited label claims per jurisdiction — including jurisdiction-specific restrictions on terms such as "hypoallergenic" or therapeutic language.

**Method**: `GET`
**Endpoint**: `/formulationcheck/claims/prohibited`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter prohibited claims by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/claims/prohibited?q=hypoallergenic" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 11. Health Check

Check API availability and retrieve operational status.

**Method**: `GET`
**Endpoint**: `/formulationcheck/health`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/formulationcheck/formulationcheck/health" \
  -H "x-api-market-key: YOUR_API_KEY"
```


## Status Codes
Below is a list of common HTTP status codes you may encounter when interacting with the FormulationCheck API:

*   **`200 OK`**: The request was successful and the server has returned the requested data.
*   **`400 Bad Request`**: The server could not process the request due to invalid input — such as a missing `ingredients` array, an unrecognized jurisdiction code in the `jurisdictions` filter, or a batch array exceeding 100 formulas. Review your request body before retrying.
*   **`401 Unauthorized`**: Authentication failed. Your `x-api-market-key` header is missing or contains an invalid key. Confirm your key is active and correctly included in the request header.
*   **`403 Forbidden`**: Your API key is valid, but your current plan does not permit access to the requested resource — for example, a batch size exceeding your plan's limit. Review your plan's permissions on RapidAPI.
*   **`404 Not Found`**: The requested endpoint or ingredient ID does not exist. Verify the URL path and resource ID against the endpoint reference above.
*   **`429 Too Many Requests`**: You have exceeded your plan's rate limit. Implement client-side rate limiting and exponential backoff. Check the `Retry-After` response header for guidance on when to retry.
*   **`500 Internal Server Error`**: An unexpected server-side error occurred. Retry the request after a short delay.
*   **`503 Service Unavailable`**: The server is temporarily unavailable due to maintenance or elevated load. Retry after a short delay.

## Rate Limits

Rate limits vary by plan:

| Plan | Price | Requests/Month | Rate Limit |
| :--- | :--- | :--- | :--- |
| **Free** | $0 | 50 | 10 req/min |
| **Pro** | $49/mo | 2,000 | 60 req/min |
| **Ultra** | $149/mo | 20,000 | 300 req/min |
| **Mega** | $399/mo | 200,000 | 1,000 req/min |

If you exceed your plan's rate limit, the API returns a `429 Too Many Requests` status code. Implement exponential backoff in your client and monitor the `Retry-After` header for retry timing guidance.

## FAQ

*   **Which jurisdictions are supported?**
    The API covers 7 jurisdictions: US FDA, EU CosIng, Health Canada, KFDA/MFDS (South Korea), ASEAN, ANVISA (Brazil), and GSO/GCC (Gulf States). Use the `/formulationcheck/jurisdictions` endpoint to retrieve the full list with metadata.

*   **Do I need to provide CAS numbers and concentrations for every ingredient?**
    Only the ingredient `name` is required per ingredient object. Providing `cas_number` improves matching accuracy, and providing `concentration_percent` is required for concentration limit violations to be detected. Analyses submitted without concentration data will still flag banned ingredients and label claim requirements.

*   **What does a `non_compliant` result mean?**
    A `non_compliant` status at the jurisdiction level indicates at least one violation — a banned ingredient, a concentration exceeding the jurisdiction's limit for the product type, or a missing required label claim. Each violation is returned with the specific ingredient, submitted vs. allowed concentration, and the regulatory citation.

*   **Are concentration limits product-type-specific?**
    Yes. Many jurisdictions enforce different limits for leave-on and rinse-off products. Where applicable, the `violation` object includes a `product_type` field indicating which product type the limit applies to.

*   **How many formulas can I batch analyze at once?**
    The `/formulationcheck/analyze/batch` endpoint accepts up to 100 formula objects per request.

*   **Can I check only specific jurisdictions rather than all 7?**
    Yes. Include a `jurisdictions` array in the `/analyze` request body with the jurisdiction codes you want to check (e.g., `["US", "EU"]`). Omitting the field runs the analysis against all 7 jurisdictions.

*   **Can I test the API without submitting a real formula?**
    Yes. The `/formulationcheck/test` endpoint runs predefined test scenarios with no formula input required. Use this to explore the response schema and validate your parsing logic before connecting a live product data source.

*   **How do I authenticate my requests?**
    All requests require an `x-api-market-key` header with your API key obtained from RapidAPI.

*   **What is the rate limit for my plan?**
    Rate limits range from 10 requests/minute on the Free plan to 1,000 requests/minute on Mega. See the Rate Limits section for the full breakdown.

## Contact Us

For questions or support, contact the developer at [21truescarystories@gmail.com](mailto:21truescarystories@gmail.com).

Cross-border regulatory compliance engine purpose-built for beauty, personal care, and supplement formulations.

FormulationCheck API