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

# List Series

Lists the series of an organization with the next folio of each environment and the CFDI types each one is the default for. Any member of the organization can read them.

For the concepts (default series, automatic and manual folios), see the [Series and folios guide](https://docs.timbrix.mx/series-y-folios.md).

## Authentication

This endpoint requires authentication with a **user session** (Bearer token). API keys are not accepted on series routes, like the other organization management routes.

* **Authorization**: `Bearer <token>`

## Path Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `organizationId` | string (UUID) | Yes | Organization ID |

## Permissions

Any **member** of the organization (Owner, Admin or Member).

## Response

Returns an array of series:

| Field | Type | Description |
| - | - | - |
| `series` | string | Series name, always uppercase |
| `nextFolio` | number | Next automatic folio in **production** |
| `nextFolioTest` | number | Next automatic folio in **sandbox** |
| `defaultFor` | array | CFDI types the series is the default for: `I`, `E`, `T` and/or `P` (empty if none) |

## Example Request

```bash theme={null}
curl -X GET https://api.timbrix.mx/organizations/550e8400-e29b-41d4-a716-446655440000/series \
  -H "Authorization: Bearer <your_token>"
```

```typescript theme={null}
import { Timbrix } from "@timbrix/sdk"

const client = new Timbrix({ bearerToken: "<your_token>" })

const series = await client.series.list("550e8400-e29b-41d4-a716-446655440000")
console.log(series)
```

## Example Response

```json theme={null}
[
  {
    "series": "A",
    "nextFolio": 16,
    "nextFolioTest": 4,
    "defaultFor": ["I", "T"]
  },
  {
    "series": "NC",
    "nextFolio": 3,
    "nextFolioTest": 1,
    "defaultFor": ["E"]
  },
  {
    "series": "P",
    "nextFolio": 9,
    "nextFolioTest": 1,
    "defaultFor": ["P"]
  }
]
```

## Common Errors

### 401 Unauthorized

Authentication required.

```json theme={null}
{
  "statusCode": 401,
  "message": "Authentication required. Provide a valid bearer token."
}
```

### 403 Forbidden

The authenticated user is not a member of the organization.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.