Skip to main content
GET
/
projects
Python (SDK)
from latitudesh_python_sdk import Latitudesh
import os


with Latitudesh(
    bearer=os.getenv("LATITUDESH_BEARER", ""),
) as latitudesh:

    res = latitudesh.projects.list(filter_tags="tag_R3YGrW8m0NSAm0l5Wp6XTnnww9r", page_size=20, page_number=1)

    while res is not None:
        # Handle items

        res = res.next()
{
  "data": [
    {
      "id": "proj_lxWpD6xKdm6rk",
      "type": "projects",
      "attributes": {
        "tags": [
          {
            "id": "tag_GGXAB6PNQbU285ZYLP3wt3ZQyXW",
            "name": "tag1",
            "description": "Nihil ullam dignissimos odio.",
            "color": "#8ac18a"
          },
          {
            "id": "tag_xR2B8J4W81TBL6YRGPJaCQRkVyn",
            "name": "tag2",
            "description": "Animi aliquid ut praesentium.",
            "color": "#028888"
          }
        ],
        "name": "Durable Steel Computer",
        "slug": "durable-steel-computer",
        "description": "Ergonomic Leather Table",
        "billing_type": "Hourly",
        "cost": null,
        "billing_method": "Normal",
        "bandwidth_alert": false,
        "environment": null,
        "provisioning_type": "on_demand",
        "billing": {},
        "team": {
          "id": "team_RrG7kyBxXrHAeYr47GJ4HpKLQQr",
          "name": "138 Team",
          "slug": "138-team",
          "description": "138 Team",
          "address": "3417 Thiel Well, Port Omar, OH 21371",
          "currency": {
            "id": "cur_AW6Q2D9lqKLpr",
            "code": "BRL",
            "name": "Brazilian Real",
            "currency_id": null
          },
          "status": "verified",
          "feature_flags": []
        },
        "stats": {
          "databases": 0,
          "ip_addresses": 0,
          "prefixes": 0,
          "servers": 0,
          "storages": 0,
          "virtual_machines": 0,
          "vlans": 0
        },
        "created_at": "2025-07-16T18:36:34+00:00",
        "updated_at": "2025-07-16T18:36:34+00:00"
      }
    }
  ],
  "meta": {}
}

Authorizations

Authorization
string
header
required

Query Parameters

filter[name]
string

The project name to filter by

filter[slug]
string

The project slug to filter by

filter[description]
string

The project description to filter by

filter[billing_type]
string

The billing type to filter by

filter[environment]
string

The environment to filter by

filter[tags]
string

The tags ids to filter by, separated by comma, e.g. filter[tags]=tag_1,tag_2will return projects with tag_1 AND tag_2

extra_fields[projects]
string

The last_renewal_date and next_renewal_date are provided as extra attributes that show previous and future billing cycle dates. To request it, just set extra_fields[projects]=last_renewal_date,next_renewal_date in the query string.

page[size]
integer
default:20

Number of items to return per page

Required range: x >= 1
page[number]
integer
default:1

Page number to return (starts at 1)

Required range: x >= 1

Response

200 - application/vnd.api+json

Success

data
object[]
I