Managing Parcels

This guide explains how to find the parcels on a project, update a parcel's properties, and link contacts to a parcel using the Glint Solar API.

Parcels are created inside the Glint Solar app from map and cadastral data, so the API has no create or delete endpoint for them.

Prerequisites

Before working with parcels, you need:

1. A valid Personal Access Token
2. An Organization ID (orgId)
3. A Portfolio ID (portfolioId)
4. A Project ID (id) to discover parcels from

You can retrieve organization and portfolio IDs using the List organizations and List portfolios endpoints.

Listing Parcels on a Project

Parcels are reached through the project they are linked to. Send a GET request to list the parcels on a project:

curl -X GET "https://api.glintsolar.com/projects/v1/pro_x1y2z3w4v5u6/parcels?orgId=YOUR_ORG_ID&portfolioId=YOUR_PORTFOLIO_ID" \
  -H "X-API-Key: YOUR_PERSONAL_ACCESS_TOKEN"

The response is a paginated list of parcels:

{
  "items": [
    {
      "id": "par_a1b2c3d4e5f6",
      "properties": {
        "name": { "text": "Gnr 12 Bnr 3" },
        "parcel-status": { "select": ["a1b2c3d4e5f6g7h8"] }
      },
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ],
  "nextKey": null
}

Use a parcel's id to update it or to manage its linked contacts below.

Discovering Parcel Properties

Like projects and contacts, parcels have dynamic properties that vary by organization. The property keys used in this guide (name, parcel-status) are the defaults, but each organization can rename or add their own. Call the schema endpoint to discover which ones are available.

This endpoint only takes an orgId:

curl -X GET "https://api.glintsolar.com/parcels/v1/schema?orgId=YOUR_ORG_ID" \
  -H "X-API-Key: YOUR_PERSONAL_ACCESS_TOKEN"

The response lists the configured properties:

{
  "properties": [
    {
      "id": "name",
      "name": "Name",
      "property_type": "text"
    },
    {
      "id": "parcel-status",
      "name": "Status",
      "property_type": "select",
      "select": {
        "options": [
          { "id": "a1b2c3d4e5f6g7h8", "name": "Signed", "color": "#3DB33D" },
          { "id": "h8g7f6e5d4c3b2a1", "name": "Positive", "color": "#4996E4" }
        ]
      }
    }
  ]
}

Use each property's id as the key when reading or setting that property. See the Managing Projects guide for the full reference on how each property type is formatted.

Updating a Parcel

To update a parcel, send a PUT request with the properties you want to change. Only include the properties you want to update — other properties remain unchanged. For select properties such as parcel-status, use an option id from the schema.

curl -X PUT "https://api.glintsolar.com/parcels/v1/par_a1b2c3d4e5f6?orgId=YOUR_ORG_ID&portfolioId=YOUR_PORTFOLIO_ID" \
  -H "X-API-Key: YOUR_PERSONAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "properties": {
      "parcel-status": { "select": ["a1b2c3d4e5f6g7h8"] }
    }
  }'

A successful request returns the updated parcel:

{
  "id": "par_a1b2c3d4e5f6",
  "properties": {
    "name": { "text": "Gnr 12 Bnr 3" },
    "parcel-status": { "select": ["a1b2c3d4e5f6g7h8"] }
  },
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T14:45:00Z"
}

Linking a Contact to a Parcel

To link a contact to a parcel, send a POST request with the contactId in the request body:

curl -X POST "https://api.glintsolar.com/parcels/v1/par_a1b2c3d4e5f6/contacts?orgId=YOUR_ORG_ID&portfolioId=YOUR_PORTFOLIO_ID" \
  -H "X-API-Key: YOUR_PERSONAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contactId": "con_a1b2c3d4e5f6"
  }'

A successful request returns a 200 status. See the Managing Contacts guide for how to find or create the contact you want to link.

Listing Contacts on a Parcel

To see which contacts are linked to a parcel, send a GET request:

curl -X GET "https://api.glintsolar.com/parcels/v1/par_a1b2c3d4e5f6/contacts?orgId=YOUR_ORG_ID&portfolioId=YOUR_PORTFOLIO_ID" \
  -H "X-API-Key: YOUR_PERSONAL_ACCESS_TOKEN"

The response is a paginated list of the linked contacts:

{
  "items": [
    {
      "id": "con_a1b2c3d4e5f6",
      "properties": {
        "first_name": { "text": "Jane" },
        "last_name": { "text": "Landowner" }
      },
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ],
  "nextKey": null
}

Unlinking a Contact from a Parcel

To remove the link between a contact and a parcel, send a DELETE request with both the parcel ID and the contact ID in the path:

curl -X DELETE "https://api.glintsolar.com/parcels/v1/par_a1b2c3d4e5f6/contacts/con_a1b2c3d4e5f6?orgId=YOUR_ORG_ID&portfolioId=YOUR_PORTFOLIO_ID" \
  -H "X-API-Key: YOUR_PERSONAL_ACCESS_TOKEN"

A successful request returns a 200 status. This only removes the link — the contact itself remains in the portfolio.