Fieldstub · Schema

Ticket

ConstructionField Service ManagementProcore IntegrationTime and MaterialsNoLogin

Properties

Name Type Description
id string
status string
project_id string
description string
reason string Why the work is out of scope.
directed_by string Who on the GC side authorized it.
captured_at string
captured_via string qr, sms, link or api.
captured_by stringnull
total number
labor array
equipment array
materials array
signature objectnull
photos array
photo_count integer
link_token stringnull
approved_by stringnull Who released the ticket into Procore: a reviewer's email address, or "key: ()" when an API key or an agent approved it. Null when the approval predates this field or no actor could be es
approved_at stringnull
decisions array Every state change a caller made, oldest first, appended and never rewritten. A ticket that was rejected and then approved anyway keeps both entries, which is the sequence an audit asks about.
procore objectnull Populated once the ticket has been written to Procore.
routing array Where each line of money will land. Present on single-ticket reads and on approve. The most important field in the payload.
warnings array
View JSON Schema on GitHub

JSON Schema

fieldstub-com-ticket-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/fieldstub-com/json-schema/fieldstub-com-ticket-schema.json",
  "title": "Ticket",
  "x-generated": "2026-11-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/fieldstub-com-openapi.json#/components/schemas/Ticket",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "status": {
      "type": "string",
      "enum": [
        "submitted",
        "written",
        "rejected"
      ]
    },
    "project_id": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "reason": {
      "type": "string",
      "description": "Why the work is out of scope."
    },
    "directed_by": {
      "type": "string",
      "description": "Who on the GC side authorized it."
    },
    "captured_at": {
      "type": "string",
      "format": "date-time"
    },
    "captured_via": {
      "type": "string",
      "description": "qr, sms, link or api."
    },
    "captured_by": {
      "type": [
        "string",
        "null"
      ]
    },
    "total": {
      "type": "number"
    },
    "labor": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/LaborLine"
      }
    },
    "equipment": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/EquipmentLine"
      }
    },
    "materials": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/MaterialLine"
      }
    },
    "signature": {
      "type": [
        "object",
        "null"
      ]
    },
    "photos": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Photo"
      }
    },
    "photo_count": {
      "type": "integer"
    },
    "link_token": {
      "type": [
        "string",
        "null"
      ]
    },
    "approved_by": {
      "type": [
        "string",
        "null"
      ],
      "description": "Who released the ticket into Procore: a reviewer's email address, or \"key:<name> (<prefix>)\" when an API key or an agent approved it. Null when the approval predates this field or no actor could be established. Procore's own audit shows the service account that wrote the change event, so this is the only record of the person."
    },
    "approved_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "decisions": {
      "type": "array",
      "description": "Every state change a caller made, oldest first, appended and never rewritten. A ticket that was rejected and then approved anyway keeps both entries, which is the sequence an audit asks about.",
      "items": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "approved",
              "rejected",
              "restored"
            ]
          },
          "by": {
            "type": [
              "string",
              "null"
            ]
          },
          "at": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "procore": {
      "type": [
        "object",
        "null"
      ],
      "description": "Populated once the ticket has been written to Procore.",
      "properties": {
        "destination": {
          "type": "string",
          "enum": [
            "change_event",
            "daily_log"
          ],
          "description": "Where it went. A change event is money on a budget code. A daily log is a dated record that bills nothing, used when the project has no Project Financials. Always present on a written ticket, so nothing has to be inferred from which id is null."
        },
        "change_event_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "manpower_log_id": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Set instead of change_event_id when destination is daily_log."
        },
        "number": {
          "type": [
            "string",
            "null"
          ]
        },
        "written_at": {
          "type": "string",
          "format": "date-time"
        },
        "url": {
          "type": "string"
        },
        "note": {
          "type": [
            "string",
            "null"
          ],
          "description": "Present on a daily log write, spelling out what that record is and is not."
        }
      }
    },
    "routing": {
      "type": "array",
      "description": "Where each line of money will land. Present on single-ticket reads and on approve. The most important field in the payload.",
      "items": {
        "$ref": "#/$defs/RoutingLine"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "$defs": {
    "EquipmentLine": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string"
        },
        "hours": {
          "type": "number"
        },
        "rate": {
          "type": "number"
        },
        "costCode": {
          "type": "string"
        }
      }
    },
    "LaborLine": {
      "type": "object",
      "properties": {
        "trade": {
          "type": "string"
        },
        "workers": {
          "type": "number",
          "default": 1
        },
        "hours": {
          "type": "number"
        },
        "rate": {
          "type": "number"
        },
        "costCode": {
          "type": "string",
          "description": "Optional. Helps route the line automatically."
        }
      },
      "required": [
        "trade",
        "hours"
      ]
    },
    "MaterialLine": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string"
        },
        "quantity": {
          "type": "number"
        },
        "unitCost": {
          "type": "number"
        },
        "costCode": {
          "type": "string"
        }
      }
    },
    "Photo": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "taken_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "coords": {
          "type": [
            "object",
            "null"
          ]
        }
      }
    },
    "RoutingLine": {
      "type": "object",
      "properties": {
        "line": {
          "type": "integer",
          "description": "Index. Use it as the key in routes on approve."
        },
        "description": {
          "type": "string"
        },
        "cost_type": {
          "type": [
            "string",
            "null"
          ]
        },
        "quantity": {
          "type": [
            "number",
            "null"
          ]
        },
        "unit_cost": {
          "type": [
            "number",
            "null"
          ]
        },
        "amount": {
          "type": "number"
        },
        "budget_code": {
          "type": [
            "string",
            "null"
          ],
          "description": "Flat code, e.g. 01-000.E."
        },
        "budget_code_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "routed": {
          "type": "boolean"
        },
        "exact": {
          "type": "boolean",
          "description": "False means a fallback code was used."
        },
        "needs_review": {
          "type": "boolean"
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/fieldstub-com-ticket"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.