Get Projects

GET https://api.podengine.ai/api/v1/projects

Get a list of projects for the authenticated user

Example request

curl -X GET "https://api.podengine.ai/api/v1/projects?states=ACTIVE" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN"

const options = {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  }
};

fetch("https://api.podengine.ai/api/v1/projects?states=ACTIVE", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.get("https://api.podengine.ai/api/v1/projects?states=ACTIVE", headers=headers)
print(response.json())

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var response = await client.GetAsync("https://api.podengine.ai/api/v1/projects?states=ACTIVE");
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.podengine.ai/api/v1/projects?states=ACTIVE", nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.projects.getProjects({
  states: ['ACTIVE'],
});

console.log(data);

import os

from podengine import PodEngine

pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])

data = pe.projects.get_projects(
    states=["ACTIVE"],
)

print(data)

200

Example response

{
  "status": "string",
  "data": {
    "options": {
      "states": [
        "DRAFT"
      ],
      "sortBy": "recent-activity"
    },
    "projects": [
      {
        "projectId": "string",
        "name": "string",
        "slug": "string",
        "teamId": "string",
        "createdAt": "2026-01-15T09:30:00.000Z",
        "lastUpdated": "2026-01-15T09:30:00.000Z",
        "createdBy": {
          "id": "string",
          "displayName": "string",
          "avatarSeed": "string"
        },
        "projectTypes": [
          "advertisers"
        ],
        "status": "DRAFT",
        "listedPodcastsCount": 0,
        "linkedGuestProfile": {
          "id": "string",
          "name": "string",
          "slug": "string",
          "status": "ACTIVE",
          "imageUrl": "string",
          "linkedinUrl": "string",
          "companyName": "string",
          "appearancesCount": 0
        },
        "stateCounts": {
          "prospect": 0,
          "qualified": 0,
          "pitched": 0,
          "booked": 0,
          "lost": 0,
          "ignored": 0
        },
        "documentsCount": {
          "total": 0,
          "processed": 0
        },
        "recentActivities": [
          {
            "type": "added-to-list",
            "date": "2026-01-15T09:30:00.000Z",
            "podcastTitle": "string",
            "podcastSlug": "string",
            "podcastImageUrl": "string",
            "toValue": "string",
            "user": {
              "id": "string",
              "displayName": "string",
              "avatarSeed": "string"
            }
          }
        ]
      }
    ]
  }
}

Request

Query parameters

statesunion

Include projects in any of these lifecycle states; omit to include all project states.

sortByenum

Project field used to order the results.

recent-activitynamecreated

Response

200 application/json

statusstringrequired

dataobjectrequired2 fields

optionsobjectrequired2 fields

statesunion

Include projects in any of these lifecycle states; omit to include all project states.

sortByenum

Project field used to order the results.

recent-activitynamecreated

projectsarray of objectrequired14 fields

projectIdstringrequired

namestringrequired

slugstringrequired

teamIdstringrequired

createdAtdaterequired

lastUpdateddaterequired

createdByobjectrequirednullable3 fields

idstringrequired

displayNamestringrequirednullable

avatarSeedstringrequirednullable

projectTypesarray of enumrequired

advertisersapicontent-creationguest-bookinginteresting-podcastslead-generationmonitoringothertranscriptions

statusenumrequired

DRAFTPENDINGACTIVEARCHIVEDERROR

listedPodcastsCountnumberrequired

linkedGuestProfileobjectrequirednullable8 fields

idstringrequired

namestringrequired

slugstringrequired

statusenumrequired

ACTIVEDRAFTPENDINGARCHIVEDERROR

imageUrlstringrequirednullable

linkedinUrlstringrequirednullable

companyNamestringrequirednullable

appearancesCountnumberrequired

stateCountsobjectrequired6 fields

prospectnumberrequired

qualifiednumberrequired

pitchednumberrequired

bookednumberrequired

lostnumberrequired

ignorednumberrequired

documentsCountobjectrequired2 fields

totalnumberrequired

processednumberrequired

recentActivitiesarray of objectrequired7 fields

typeenumrequired

added-to-listupdate-labelsupdate-priorityupdate-state

datedaterequired

podcastTitlestringrequirednullable

podcastSlugstringrequirednullable

podcastImageUrlstringrequirednullable

toValuestringrequirednullable

userobjectrequirednullable3 fields

idstringrequired

displayNamestringrequirednullable

avatarSeedstringrequirednullable