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

# Getting Started

> Introducing the general concepts for using the PDF.co API, authentication methods, response codes and sample code.

## API Reference

The PDF.co Web API is REST-based, making it intuitive and easy to use. To prioritize your data’s security and privacy, all requests are securely transmitted using HTTPS. Kindly note, unsecured HTTP connections are not supported.

All requests contain the following **base URL**:

`https://api.pdf.co/v1`

## Authenticating Your API Request

To authenticate you need to add a header named `x-api-key` using your API Key as the value.

```javascript theme={null}
"x-api-key": "sample@sample.com_123a4b567c890d123e456f789g01"
```

<Note>
  The key provided above is just a sample and won’t work for actual API calls. Don’t forget to replace it with your real API Key, which you can find in your [PDF.co Dashboard](https://app.pdf.co/), when making requests.
</Note>

## Response codes

After making a request you will receive a response from the **PDF.co** API. A code `200` means the request was successfull, a `400` means there was an error. However there could be other codes - see [the complete list of available response codes](/api-reference/response-codes).

## Sample Code

Here is some sample code which would convert a **PDF** to a **CSV** file.

<Tabs>
  <Tab title="JavaScript">
    ```javascript theme={null}
    var data = {
                  "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-csv/sample.pdf",
                  "lang": "eng",
                  "inline": true,
                  "pages": "0-",
                  "async": false,
                  "name": "result.csv"
                }

    fetch('https://api.pdf.co/v1/pdf/convert/to/csv', {
        method: 'POST',
        headers: {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'x-api-key': 'sample@sample.com_123a4b567c890d123e456f789g01'
        },
        body: JSON.stringify(data)
    })
       .then(response => response.json())
       .then(response => console.log(JSON.stringify(response)))
    ```
  </Tab>

  <Tab title="CURL">
    ```bash theme={null}
    curl --location --request POST 'https://api.pdf.co/v1/pdf/convert/to/csv' \
    --header 'Content-Type: application/json' \
    --header 'x-api-key: sample@sample.com_123a4b567c890d123e456f789g01' \
    --data-raw '{
        "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-csv/sample.pdf",
        "lang": "eng",
        "inline": true,
        "pages": "0-",
        "async": false,
        "name": "result.csv"
    }'
    ```
  </Tab>
</Tabs>