--- updatedAt: 2026-06-03T14:46:59.000Z agentTools: projectIndex: https://developers.fieldwire.com/llms.txt --- # Get user by ID Gets a user on your account by Id. The API also returns the count of projects that user is in. ```json { "user": { "created_at": "2019-10-15T19:49:01.802Z", "updated_at": "2021-03-12T22:29:06.467Z", "email_addresses": [ { "email": "owner@construction.com", "is_primary": true } ], "id": 2141, "account_id": 2153, "company": "Construction.com", "company_type": null, "email": "owner@construction.com", "first_name": "Owner", "in_app_purchase_end_at": null, "invited_by_id": 18, "is_confirmed": true, "is_email_deliverable": true, "job_title": "Owner", "language": "en", "last_name": "Name", "phone_number": "3343434343", "photo_url": "https://s3.amazonaws.com/photo.png", "current_sign_in_at": "2021-03-12T22:29:06.454Z", "account_role": "account_admin", "email_notifications": "instantly", "sync_scheme": "smart_cellular" }, "projects": 165 } ``` # OpenAPI definition ````json { "openapi": "3.0.3", "info": { "title": "Fieldwire Super API", "version": "v3" }, "servers": [ { "url": "https://client-api.super.fieldwire.com" } ], "components": { "parameters": { "id": { "name": "id", "in": "path", "description": "ID of the entity", "required": true, "schema": { "type": "integer", "format": "int32" } } }, "schemas": { "account_user": { "type": "object", "nullable": false, "description": "General info for user in an account with count of account projects involved in", "required": [ "user", "projects" ], "properties": { "user": { "$ref": "#/components/schemas/user" }, "projects": { "type": "integer", "description": "Number of projects in this account this user is a part of", "nullable": false } }, "additionalProperties": false }, "user": { "type": "object", "description": "General information of a user", "required": [ "id", "is_email_deliverable", "email", "first_name", "language", "last_name", "sync_scheme", "created_at", "updated_at" ], "nullable": false, "properties": { "id": { "type": "integer", "format": "int32", "description": "ID of user", "nullable": false }, "account_id": { "type": "integer", "format": "int32", "nullable": false, "description": "ID of the account this user belongs to" }, "invited_by_id": { "type": "integer", "format": "int32", "nullable": true, "description": "ID of the user who invited this user to the platform" }, "is_email_deliverable": { "type": "boolean", "nullable": false, "description": "If email can be delivered to this user" }, "company": { "type": "string", "nullable": true, "description": "Name of the company this user belongs to" }, "company_type": { "type": "string", "nullable": true, "enum": [ "ARCHITECT_SLASH_DESIGNER", "GENERAL_CONTRACTOR", "OWNER", "SPECIALTY_CONTRACTOR", "OTHER", null ], "description": "Type of the company this user belongs to" }, "email": { "type": "string", "nullable": false, "description": "Email of this user" }, "first_name": { "type": "string", "nullable": false, "description": "First name of this user" }, "job_title": { "type": "string", "nullable": true, "description": "Title this user holds at their job" }, "language": { "type": "string", "nullable": false, "description": "Preferred language of this user" }, "last_name": { "type": "string", "nullable": false, "description": "Last name of this user" }, "phone_number": { "type": "string", "nullable": true, "description": "Phone number of this user" }, "photo_url": { "type": "string", "nullable": true, "description": "URL where the profile picture of this user lives" }, "email_notifications": { "type": "string", "enum": [ "never", "daily", "instantly", null ], "nullable": true, "description": "Email notification preference of this user for delivering task updates" }, "sync_scheme": { "type": "string", "enum": [ "smart_cellular", "full_cellular" ], "nullable": false, "description": "Synchronization scheme of this user used by the mobile apps" }, "account_role": { "type": "string", "enum": [ "account_member", "account_admin" ], "nullable": false, "description": "The role of the user in the account they belong to" }, "email_addresses": { "type": "array", "deprecated": true, "nullable": false, "description": "Deprecated. Use the \"email\" property instead", "items": { "type": "object", "nullable": false, "description": "Email associated with the user account" } }, "is_confirmed": { "type": "boolean", "nullable": false, "description": "Whether the user has accepted the invitation if there was one" }, "created_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Time when the server created this user" }, "current_sign_in_at": { "type": "string", "format": "date-time", "nullable": true, "description": "Last time the user was seen online" }, "in_app_purchase_end_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When the in app purchase this user made ends" }, "updated_at": { "type": "string", "format": "date-time", "nullable": false, "description": "Time when the server last updated this user" }, "trade_type": { "type": "string", "nullable": true, "enum": [ "CONCRETE", "EARTHWORK", "ELECTRICAL", "FIRE_SUPPRESSION", "FRAMING_AND_OR_DRYWALL", "HVAC", "LOW_VOLTAGE", "MECHANICAL", "PLUMBING", "UTILITIES", "OTHER", null ], "description": "Type of the trade this user's company belongs to" } }, "additionalProperties": false } }, "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": { "/account/users/{id}": { "get": { "summary": "Get user by ID", "operationId": "get_user_by_id", "tags": [ "account users" ], "description": "Gets a user on your account by Id. The API also returns the count of projects that user is in.\n\n```json\n\n{\n \"user\": {\n \"created_at\": \"2019-10-15T19:49:01.802Z\",\n \"updated_at\": \"2021-03-12T22:29:06.467Z\",\n \"email_addresses\": [\n {\n \"email\": \"owner@construction.com\",\n \"is_primary\": true\n }\n ],\n \"id\": 2141,\n \"account_id\": 2153,\n \"company\": \"Construction.com\",\n \"company_type\": null,\n \"email\": \"owner@construction.com\",\n \"first_name\": \"Owner\",\n \"in_app_purchase_end_at\": null,\n \"invited_by_id\": 18,\n \"is_confirmed\": true,\n \"is_email_deliverable\": true,\n \"job_title\": \"Owner\",\n \"language\": \"en\",\n \"last_name\": \"Name\",\n \"phone_number\": \"3343434343\",\n \"photo_url\": \"https://s3.amazonaws.com/photo.png\",\n \"current_sign_in_at\": \"2021-03-12T22:29:06.454Z\",\n \"account_role\": \"account_admin\",\n \"email_notifications\": \"instantly\",\n \"sync_scheme\": \"smart_cellular\"\n },\n \"projects\": 165\n}\n\n```", "security": [ { "jwt": [] } ], "parameters": [ { "$ref": "#/components/parameters/id" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "example": { "user": { "created_at": "2023-10-17T21:04:50.722Z", "updated_at": "2023-10-17T21:04:50.723Z", "email_addresses": [ { "email": "9df9f793-f3ee-4eca-bdfe-c31cabbc6675@factory.com", "is_primary": true } ], "id": 13, "account_id": 9, "company": "Company", "company_type": null, "email": "9df9f793-f3ee-4eca-bdfe-c31cabbc6675@factory.com", "first_name": "John", "invited_by_id": null, "is_confirmed": true, "is_email_deliverable": true, "job_title": null, "language": "en", "last_name": "Doe", "phone_number": null, "photo_url": null, "trade_type": null, "current_sign_in_at": "2023-10-17T21:04:50.721Z", "in_app_purchase_end_at": null, "account_role": "account_admin", "email_notifications": "instantly", "sync_scheme": "smart_cellular" }, "projects": 1 }, "schema": { "$ref": "#/components/schemas/account_user" } } } } } } } } } ````