--- updatedAt: 2026-06-03T14:46:37.000Z agentTools: projectIndex: https://developers.fieldwire.com/llms.txt --- # Show all projects in an account # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "Fieldwire Regional API", "version": "v3" }, "servers": [ { "url": "https://client-api.{region}.fieldwire.com", "variables": { "region": { "default": "us", "enum": [ "ca", "eu", "us" ] } } } ], "components": { "headers": { "current_user_id": { "description": "Current user's id", "schema": { "type": "integer" } } }, "parameters": { "api_version": { "name": "Fieldwire-Version", "in": "header", "description": "Specifies the version of the API to talk to", "required": true, "schema": { "type": "string", "format": "date" } } }, "schemas": { "project_for_account": { "type": "object", "required": [ "id", "account_id", "has_logo", "is_email_notifications_enabled", "is_enterprise", "is_premium", "prompt_effort_on_complete", "color", "currency", "man_power_units", "name", "time_zone", "created_at", "device_created_at", "resolved_conflict", "device_updated_at", "updated_at" ], "nullable": false, "description": "Entity that denotes a Fieldwire project for accounts", "additionalProperties": true, "properties": { "id": { "type": "string", "format": "uuid", "nullable": false, "description": "ID of the entity" }, "account_id": { "type": "integer", "format": "int32", "nullable": false, "description": "Account id project is under" }, "has_logo": { "type": "boolean", "nullable": false, "description": "Boolean if project has logo" }, "is_3d_bim_enabled": { "type": "boolean", "nullable": true, "description": "If 3D BIM is enabled for this project" }, "is_email_notifications_enabled": { "type": "boolean", "nullable": false, "description": "Whether email notifications are enabled for this project" }, "prompt_effort_on_complete": { "type": "boolean", "nullable": false, "description": "Whether prompt to input effort should be shown on marking tasks as completed" }, "address": { "type": "string", "nullable": true, "description": "Address of this project" }, "code": { "type": "string", "nullable": true, "description": "Code of this project" }, "color": { "type": "string", "nullable": false, "description": "Color to use for this project for highlighting in the UI" }, "currency": { "type": "string", "nullable": false, "description": "Currency to use for the `cost_value` of `Task`s in this project" }, "default_pm_group_id": { "type": "string", "format": "uuid", "nullable": true, "description": "The default PmGroup for this project, if it is a PM-enabled project" }, "logo_url": { "type": "string", "nullable": true, "description": "URL of the logo for this project" }, "man_power_units": { "type": "string", "nullable": false, "description": "Unit to use for the `man_power_value` of `Task`s in this project" }, "name": { "type": "string", "nullable": false, "description": "Name of this project" }, "time_zone": { "type": "string", "nullable": false, "description": "Timezone of this project" }, "sheets_limit": { "type": "integer", "format": "int32", "nullable": true, "description": "Count of the latest sheet versions that should be cached on the mobile apps" }, "owner_email": { "type": "string", "nullable": true, "description": "Email of user who owns the project" }, "plan_name": { "type": "string", "enum": [ "Basic", "Pro", "Business", "Enterprise" ], "nullable": false, "description": "Tier this project belongs to" }, "is_premium": { "type": "boolean", "nullable": false, "description": "If this is a premium project" }, "is_enterprise": { "type": "boolean", "nullable": false, "description": "If this project is an enterprise project" }, "archived_at": { "type": "string", "format": "date-time", "nullable": true, "description": "Time when this project was archived" }, "trash_emptied_at": { "type": "string", "format": "date-time", "nullable": true, "description": "Time when this project's trash was last emptied" }, "trash_emptied_by_user_id": { "type": "integer", "format": "int32", "nullable": true, "description": "Id of the user who last emptied this project's trash" }, "created_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Time when the server created the entity" }, "device_created_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Time when the device created the entity" }, "resolved_conflict": { "type": "boolean", "nullable": false, "description": "Specifies if PUT/PATCH request was rejected - do not store this field!" }, "device_updated_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Time when the device last updated the entity" }, "updated_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Time when the server last updated the entity" }, "deleted_at": { "type": "string", "format": "date-time", "nullable": true, "description": "Time the server deleted the entity" } } } }, "securitySchemes": { "jwt": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Access token (JWT) generated using the acquired refresh token (API token). Our [authentication](https://developers.fieldwire.com/docs/authentication) guide covers the steps to generate a valid token" } } }, "paths": { "/api/v3/account/projects": { "get": { "summary": "Show all projects in an account", "operationId": "get_projects_in_account", "tags": [ "projects" ], "security": [ { "jwt": [] } ], "parameters": [ { "$ref": "#/components/parameters/api_version" }, { "name": "Fieldwire-Filter", "in": "header", "description": "Specifies if request should include all, deleted or active (default) entities", "required": false, "schema": { "type": "string", "enum": [ "all", "active", "deleted" ] } } ], "responses": { "200": { "description": "Successful response", "headers": { "X-Current-User-Id": { "$ref": "#/components/headers/current_user_id" } }, "content": { "application/json": { "example": [ { "deleted_at": null, "created_at": "2026-10-02T14:47:48.237Z", "updated_at": "2026-10-02T14:47:48.243Z", "resolved_conflict": false, "device_created_at": "2026-10-02T14:47:48.237Z", "device_updated_at": "2026-10-02T14:47:48.237Z", "account_id": 164, "address": "address 1", "anchor_region": "us", "archived_at": null, "code": null, "color": "#F9CD39", "currency": "USD", "default_pm_group_id": null, "has_logo": true, "id": "3a5260ad-156b-49f9-acbb-53dfd5ef2552", "is_3d_bim_enabled": true, "is_mobile_location_creation_enabled": true, "is_email_notifications_enabled": true, "man_power_units": "man-hours", "name": "project 1", "owner_email": "5211826e-e223-43e9-96c6-2c87346dd0a8@factory.com", "plan_name": "Enterprise", "prompt_effort_on_complete": false, "sheets_limit": null, "time_zone": "UTC", "is_analytics_enabled": true, "min_api_version": null, "is_submittals_enabled": false, "is_project_labels_enabled": true, "project_attributes": [], "is_change_orders_enabled": false, "is_budget_enabled": false, "trash_emptied_at": null, "trash_emptied_by_user_id": null, "is_pm_enabled": false, "is_field_enabled": true, "is_plan_text_search_enabled": true, "is_premium": true, "is_enterprise": true, "logo_url": null, "work_week": [ true, true, true, true, true, true, true ], "is_ai_enabled": false, "is_mfa_enabled": false }, { "deleted_at": null, "created_at": "2026-10-02T14:47:48.256Z", "updated_at": "2026-10-02T14:47:48.262Z", "resolved_conflict": false, "device_created_at": "2026-10-02T14:47:48.256Z", "device_updated_at": "2026-10-02T14:47:48.256Z", "account_id": 164, "address": "address 1", "anchor_region": "us", "archived_at": null, "code": null, "color": "#F9CD39", "currency": "USD", "default_pm_group_id": null, "has_logo": true, "id": "f2ae3457-2784-476d-982a-ce976506ec5c", "is_3d_bim_enabled": true, "is_mobile_location_creation_enabled": true, "is_email_notifications_enabled": true, "man_power_units": "man-hours", "name": "project 1", "owner_email": "5211826e-e223-43e9-96c6-2c87346dd0a8@factory.com", "plan_name": "Enterprise", "prompt_effort_on_complete": false, "sheets_limit": null, "time_zone": "UTC", "is_analytics_enabled": true, "min_api_version": null, "is_submittals_enabled": false, "is_project_labels_enabled": true, "project_attributes": [], "is_change_orders_enabled": false, "is_budget_enabled": false, "trash_emptied_at": null, "trash_emptied_by_user_id": null, "is_pm_enabled": false, "is_field_enabled": true, "is_plan_text_search_enabled": true, "is_premium": true, "is_enterprise": true, "logo_url": null, "work_week": [ true, true, true, true, true, true, true ], "is_ai_enabled": false, "is_mfa_enabled": false } ], "schema": { "type": "array", "items": { "$ref": "#/components/schemas/project_for_account" } } } } } } } } } } ```