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

# MongoDB Atlas

> Connect MongoDB Atlas with Pelanor to enable granular cost allocation of MongoDB entities.

## Integration Basics

* **One integration per MongoDB organisation** – each org ID needs its own connector
* New uploads for a month **replace** any existing data for that month
* Data usually appears in Pelanor within **≈ 12 hours** of upload

## Integration Methods

1. **In-Platform Integration** – *coming soon*
2. **API Integration** – programmatic uploads\
   [API Docs (US Environment)](https://app.pelanor.io/api-docs) | [API Docs (EU Environment)](https://app-eu.pelanor.io/api-docs)

***

## Getting Your MongoDB Invoice Data

<Steps>
  <Step title="Log into MongoDB Atlas">
    Access the account for the organisation you want to integrate.
  </Step>

  <Step title="Navigate to Invoices">
    Go to **Billing → Invoices**.
  </Step>

  <Step title="Download invoice">
    Locate the invoice for the desired billing period and click **Download**.
  </Step>

  <Step title="Choose export format">
    Select **CSV Usage Summary**.
  </Step>

  <Step title="Save the file">
    Save the file **without making any changes**.
  </Step>
</Steps>

<Warning>
  Use the CSV <strong>exactly as downloaded</strong> from MongoDB. Any edits may break the import.
</Warning>

***

## File Format Details

| Field Name          | Description                              | Format / Example                 |
| ------------------- | ---------------------------------------- | -------------------------------- |
| `Date`              | Date the invoice was generated           | `MM/DD/YYYY` (e.g. `05/19/2024`) |
| `Usage Date`        | Date the usage occurred                  | `MM/DD/YYYY`                     |
| `Description`       | Concatenation of **SKU** and **Cluster** | String                           |
| `Note`              | Details the credit type                  | *Optional* string                |
| `Organization Name` | Name of the organisation                 | String                           |
| `Organization ID`   | Org identifier                           | String                           |
| `Project`           | Project name                             | *Optional* string                |
| `Project ID`        | Project identifier                       | *Optional* string                |
| `SKU`               | Service description                      | String                           |
| `Region`            | Region information                       | String                           |
| `Cluster`           | Cluster name                             | *Optional* string                |
| `Replica Set`       | —                                        | *Optional* string                |
| `Config Server`     | —                                        | *Optional* string                |
| `Application`       | Application identifier                   | *Optional* string                |
| `Unit`              | Type of consumption †                    |                                  |