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

# Introduction

> COR API Documentation - Integrate with projectcor.com applications

# COR API

The COR API lets you integrate with projectcor.com applications using simple HTTP methods, in either XML or JSON formats, making this an ideal API for developing integrations with other softwares, external clients or mobile applications.

## Base URL

All API requests should be made to:

```
https://api.projectcor.com/v1
```

## Authentication

The COR API uses OAuth 2.0 with multiple authentication flows. All authenticated endpoints require a Bearer token in the Authorization header.

### Authentication Methods

The API supports three authentication methods:

1. **Client Credentials** - For server-to-server authentication using API keys
2. **Authorization Code** - For user authorization via consent screen
3. **User Credentials** - For direct username/password authentication

<Card title="Authentication Endpoints" icon="key" href="/api-reference/auth/jwt-authorization-by-client-credentials">
  Learn about the different authentication methods available
</Card>

### Using Access Tokens

Once authenticated, include the access token in all API requests:

```bash theme={null}
Authorization: Bearer {access_token}
```

<Tip>
  Access tokens expire after a period of time. Use the refresh token endpoint to obtain a new access token without re-authenticating.
</Tip>

## Request Format

The API accepts requests in JSON format. Some endpoints also support `application/x-www-form-urlencoded` format.

### Headers

All requests should include:

```
Content-Type: application/json
Authorization: Bearer {access_token}
```

## Response Format

All responses are returned in JSON format. The API uses standard HTTP status codes:

* `200` - Success
* `204` - Success (No Content)
* `400` - Bad Request
* `401` - Unauthorized
* `404` - Not Found
* `500` - Server Error

## Pagination

Many list endpoints support pagination. By default, endpoints return 20 items per page. Use the `page` parameter to navigate through results.

## Rate Limiting

<Info>
  Rate limiting information will be provided here. Please contact support for current rate limits.
</Info>

## OpenAPI Specification

This documentation is generated from our OpenAPI specification file.

<Card title="View OpenAPI Specification" icon="code" href="https://github.com/your-org/developers/blob/main/api-reference/openapi.json">
  View the complete OpenAPI specification file
</Card>

## Getting Started

<Steps>
  <Step title="Obtain API Credentials">
    Contact your COR administrator to obtain API credentials (API Key and Client Secret).
  </Step>

  <Step title="Authenticate">
    Use one of the authentication methods to obtain an access token.

    <Card title="Client Credentials" href="/api-reference/auth/jwt-authorization-by-client-credentials" />
  </Step>

  <Step title="Make Your First Request">
    Use the access token to make authenticated API requests.

    <Card title="Get Clients" href="/api-reference/clients/get-clients" />
  </Step>
</Steps>