For the complete documentation index, see [llms.txt](https://docs.pandium.com/llms.txt). This page is also available as [Markdown](https://docs.pandium.com/getting-started/pandium-integration-development-kit-idk/pandium-clients.md).

Pandium's Clients fill a gap in the market by offering B2B SaaS organizations out-of-the-box plumbing for **connecting directly with APIs** to build and launch integrations.

## Why Use the Pandium Clients?

1. Pandium has [hundreds of pre-built connectors](https://docs.pandium.com/connectors/connectors-101) to choose from.
2. Our API clients seamlessly interact with APIs. They take care of paging, automatic retries, and rate limiting - all ensuring optimized throughput.
3. Our API clients also provide context-aware code insights on the APIs being integrated. This **eliminates the need to constantly reference API docs** while coding an integration’s business logic.

## How to Access the Pandium Clients

1. Pull your code from your remote repository down onto your local machine to start working in your IDE with the client in the integration.
2. You will see an example of how to instantiate the client. If you included code generation, you will see the client passed to a flow. Within the flow, the client instance will have been used to either fetch or post something to the API.
   
If you did not include code generation, you will see the client used to fetch some records.

## How to Use a Pandium Client

1. Once a client has been added to your project, import your client to any file in the project using

## Import Format
   ```
   import [Client Name] from '@pandium/[connector]-client'
   ```

## Importing ShipBob Client
   ```
   import ShipbobClient from '@pandium/shipbob-client'
   ```

## How to import additional models
   Example
   ```
   import { CreateTicketModel } from '@pandium/shipbob-client'
   ```

## Example of using client
```javascript
import ShipbobClient from '@pandium/shipbob-client'

try {
    const sbClient = new ShipbobClient()
    console.error('Fetching and logging out some ShipBob channels')
    let recordCounter = 0

// List and print 10 channels from api
    const channels = await sbClient.listChannels()
    for (const record of channels) {
        if (recordCounter > 10) break
        console.error(record.id)
        recordCounter++
    }
} catch (error) {
    console.error(':x: Unexpected ShipBob error.')
    console.error(error)
}
```
