Get Projects List

Overview

The Get Projects List allows you to retrieve a list of projects available.

Endpoint

GET https://api.peekshot.com/api/v1/projects

Request Headers

Header	Description
x-api-key	Your unique API key for authentication.

Query Parameters

Parameter	Type	Required	Default	Description
name	string	No	-	To search by name.
page	number	No	1	The page number for paginated results.
limit	number	No	10	The number of results per page.

Example Request (Using Axios)

cURL

curl --location 'https://api.peekshot.com/api/v1/projects' \
--header 'x-api-key: your-api-key'

Node.js

const axios = require('axios');

const config = {
method: 'get',
url: 'https://api.peekshot.com/api/v1/projects',
headers: {
'x-api-key': 'your-api-key'
}
};

axios.request(config)
.then(response => console.log(response.data))
.catch(error => console.error(error));

Python

import requests

url = "https://api.peekshot.com/api/v1/projects"
headers = {
    "x-api-key": "your-api-key"
}

response = requests.get(url, headers=headers)
print(response.text)

Go

import requests

url = "https://api.peekshot.com/api/v1/projects"
headers = {
"x-api-key": "your-api-key"
}

response = requests.get(url, headers=headers)
print(response.text)

Java

import requests

url = "https://api.peekshot.com/api/v1/projects"
headers = {
    "x-api-key": "your-api-key"
}

response = requests.get(url, headers=headers)
print(response.text)

PHP

import requests

url = "https://api.peekshot.com/api/v1/projects"
headers = {
"x-api-key": "your-api-key"
}

response = requests.get(url, headers=headers)
print(response.text)

Ruby

import requests

url = "https://api.peekshot.com/api/v1/projects"
headers = {
    "x-api-key": "your-api-key"
}

response = requests.get(url, headers=headers)
print(response.text)

Example Response

{
  "status": "success",
  "message": "Projects fetched successfully",
  "data": {
    "projects": [
      {
        "id": 11,
        "name": "Delta",
        "createdAt": "2025-02-25T04:58:28.205Z",
        "updatedAt": "2025-02-25T04:58:28.205Z",
        "createdByUser": {
          "id": 21,
          "email": "john.doe@gmail.com",
          "firstName": "John",
          "lastName": "Doe"
        }
      }
    ],
    "meta": {
      "currentPage": 1,
      "totalProjects": 1,
      "limit": 10
    }
  },
  "statusCode": 200
}

Error Responses

Status Code	Error Message	Description
400	Invalid Request	Check your input parameters.
403	Forbidden	Invalid or inactive API key.
500	Internal Server Error	Issue on the server side.

Notes

• API requests must include a valid x-api-key in the headers.

For further assistance, contact hello@peekshot.com.