--- updatedAt: 2026-06-20T05:55:11.000Z agentTools: projectIndex: https://docs.fabrica.land/llms.txt --- # Get the status of a proof-of-ownership workflow for a property by its tokenId Get the proof-of-ownership progress for a specific Fabrica v3 token, by the provided tokenId # OpenAPI definition ```json { "openapi": "3.0.0", "paths": { "/proof-of-ownership/{networkName}/{contractAddress}/{tokenId}": { "get": { "description": "Get the proof-of-ownership progress for a specific Fabrica v3 token, by the provided tokenId", "operationId": "getProofOfOwnership", "parameters": [ { "name": "tokenId", "required": true, "in": "path", "schema": { "example": "12345678901234567890", "type": "string" } }, { "name": "contractAddress", "required": true, "in": "path", "schema": { "example": "0xb52ED2Dc8EBD49877De57De3f454Fd71b75bc1fD", "type": "string" } }, { "name": "networkName", "required": true, "in": "path", "schema": { "$ref": "#/components/schemas/NetworkName" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProofOfOwnershipDto" } } } } }, "security": [ { "BearerToken": [] }, { "DynamicXyzJwt": [] } ], "summary": "Get the status of a proof-of-ownership workflow for a property by its tokenId", "tags": [ "Proof-of-Ownership" ] } } }, "info": { "title": "fabrica-v3-api", "description": "Fabrica V3 Token API built in TypeScript, Nest.js, and GraphQL", "version": "2.1.3", "contact": { "name": "Fabrica Inc.", "url": "https://www.fabrica.land/", "email": "hello@fabrica.land" } }, "servers": [ { "url": "https://api.fabrica.land" }, { "url": "https://go.fabrica.land" }, { "url": "https://media.fabrica.land" }, { "url": "https://metadata.fabrica.land" } ], "components": { "securitySchemes": { "BearerToken": { "scheme": "bearer", "bearerFormat": "JWT", "type": "http" }, "DynamicXyzJwt": { "scheme": "bearer", "bearerFormat": "jwt", "type": "http" } }, "schemas": { "NetworkName": { "type": "string", "enum": [ "ethereum", "sepolia" ] }, "ProofOfOwnershipDto": { "type": "object", "properties": { "workflow": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workflow": { "type": "string", "enum": [ "change-of-ownership", "loans", "offramp", "onramp", "proof-of-ownership" ] }, "network": { "type": "string", "enum": [ "ethereum", "sepolia" ] }, "contractAddress": { "description": "Must be a valid Ethereum address, matching the RegEx pattern /^0x[a-fA-F0-9]{40}$/", "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "tokenId": { "type": "string", "pattern": "^[0-9]+$" } }, "required": [ "id", "workflow", "network", "contractAddress", "tokenId" ] }, "createdAt": { "type": "string", "pattern": "^\\d{1,4}(-\\d{2}(-\\d{2}(T\\d{2}(:\\d{2}(:\\d{2}(\\.\\d{3,6})?)?)?)?(Z|([+-]\\d{2}(:\\d{2})?))?)?)?$" }, "updatedAt": { "type": "string", "pattern": "^\\d{1,4}(-\\d{2}(-\\d{2}(T\\d{2}(:\\d{2}(:\\d{2}(\\.\\d{3,6})?)?)?)?(Z|([+-]\\d{2}(:\\d{2})?))?)?)?$" }, "owners": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" }, "minItems": 1 }, "ownerType": { "type": "string", "enum": [ "concurrent", "entity", "individual" ], "description": "DEPRECATED: Use owners array; Whether the property is currently owned by an individual person or a legal entity" }, "legalFirstName": { "type": "string", "minLength": 1, "description": "DEPRECATED: Use owners array; The legal first (given) name either of the current owner of the property, or of the person authorized to administer the property on behalf of the entity that owns the property" }, "legalMiddleName": { "type": "string", "minLength": 1, "nullable": true, "description": "DEPRECATED: Use owners array; The legal middle name or initial either of the current owner of the property, or of the person authorized to administer the property on behalf of the entity that owns the property" }, "legalLastName": { "type": "string", "minLength": 1, "description": "DEPRECATED: Use owners array; The legal last name (surname) either of the current owner of the property, or of the person authorized to administer the property on behalf of the entity that owns the property" }, "legalFullName": { "type": "string", "minLength": 1, "description": "DEPRECATED: Use owners array; The legal name either of the current owner of the property, or of the person authorized to administer the property on behalf of the entity that owns the property" }, "email": { "oneOf": [ { "type": "string", "pattern": "^\\w+([-+.']\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$" }, { "type": "string" } ] }, "incorporationJurisdiction": { "type": "string", "minLength": 1, "nullable": true, "description": "DEPRECATED: Use owners array; For entity owners only, the ISO-3166-1 or ISO-3166-2 jurisdiction (`US-` followed by lower-case two-letter state, for the US) in which the owning entity is incorporated" }, "entityType": { "type": "string", "minLength": 1, "nullable": true, "description": "DEPRECATED: Use owners array; For entity owners only, the type of the entity" }, "entityName": { "type": "string", "minLength": 1, "nullable": true, "description": "DEPRECATED: Use owners array; For entity owners only, the legal name of the entity " }, "entityRole": { "type": "string", "minLength": 1, "nullable": true, "description": "DEPRECATED: Use owners array; For entity owners only, the role within the entity of the person submitted for the `legalFullName` property" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "order": { "type": "integer", "minimum": 0 }, "key": { "type": "string", "enum": [ "collect-info-from-user", "doc-setup", "property-research", "research-review", "sign-and-notarize" ] }, "status": { "type": "string", "enum": [ "not-started", "in-progress", "complete", "failed" ] }, "text": { "type": "string", "minLength": 1 }, "textCompleted": { "type": "string", "minLength": 1 }, "userActions": { "type": "array", "items": { "type": "object", "properties": { "order": { "type": "integer", "minimum": 0 }, "key": { "type": "string", "pattern": "^[a-z0-9_.]+(-[a-z0-9_.]+)*$" }, "prompt": { "type": "string", "minLength": 1 }, "detail": { "type": "string", "minLength": 1 }, "label": { "type": "string", "minLength": 1 }, "url": { "oneOf": [ { "type": "string", "minLength": 0, "maxLength": 0 }, { "type": "string", "format": "uri", "pattern": "^https?:\\/\\/" } ] }, "disposition": { "type": "string", "enum": [ "document", "external", "fee", "modal" ] }, "mimeType": { "type": "string", "pattern": "^[^\\s/]+\\/[^\\s;]+(?:[ \\t]*;[^\\r\\n]*\\S)?$" }, "signers": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "signerType": { "type": "string", "enum": [ "concurrent" ] }, "qualifier": { "type": "string", "minLength": 1 }, "signers": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" } } }, "required": [ "signerType", "qualifier", "signers" ] }, { "type": "object", "properties": { "signerType": { "type": "string", "enum": [ "entity" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "type": { "type": "string", "minLength": 1, "maxLength": 255 }, "jurisdiction": { "type": "string", "minLength": 1, "maxLength": 255 }, "signers": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" } } }, "required": [ "signerType", "name", "signers" ] }, { "type": "object", "properties": { "signerType": { "type": "string", "enum": [ "individual" ] }, "role": { "type": "string", "minLength": 1, "nullable": true }, "firstName": { "type": "string", "minLength": 1 }, "middleName": { "type": "string", "minLength": 1, "nullable": true }, "lastName": { "type": "string", "minLength": 1 }, "fullName": { "type": "string", "minLength": 1 }, "email": { "oneOf": [ { "type": "string", "pattern": "^\\w+([-+.']\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$" }, { "type": "string" } ], "nullable": true }, "signers": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" } } }, "required": [ "signerType", "firstName", "lastName", "fullName" ] } ] } }, "amount": { "type": "string", "pattern": "^[0-9]+(\\.[0-9]+)?$" }, "currency": { "description": "Must be a valid Ethereum address, matching the RegEx pattern /^0x[a-fA-F0-9]{40}$/", "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "contractAuthorized": { "description": "Must be a valid Ethereum address, matching the RegEx pattern /^0x[a-fA-F0-9]{40}$/", "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "automateCollection": { "type": "boolean" } }, "required": [ "order", "key", "prompt", "label", "disposition" ] } }, "started": { "type": "string", "pattern": "^\\d{1,4}(-\\d{2}(-\\d{2}(T\\d{2}(:\\d{2}(:\\d{2}(\\.\\d{3,6})?)?)?)?(Z|([+-]\\d{2}(:\\d{2})?))?)?)?$", "nullable": true }, "expectedDurationSeconds": { "type": "integer", "minimum": 0, "nullable": true }, "expectedCompletion": { "type": "string", "pattern": "^\\d{1,4}(-\\d{2}(-\\d{2}(T\\d{2}(:\\d{2}(:\\d{2}(\\.\\d{3,6})?)?)?)?(Z|([+-]\\d{2}(:\\d{2})?))?)?)?$", "nullable": true }, "completed": { "type": "string", "pattern": "^\\d{1,4}(-\\d{2}(-\\d{2}(T\\d{2}(:\\d{2}(:\\d{2}(\\.\\d{3,6})?)?)?)?(Z|([+-]\\d{2}(:\\d{2})?))?)?)?$", "nullable": true }, "visibility": { "type": "boolean" }, "substeps": { "type": "array", "items": { "type": "object", "properties": { "order": { "type": "integer", "minimum": 0 }, "key": { "type": "string", "enum": [ "collect-info-from-user", "doc-setup", "property-research", "research-review", "sign-and-notarize" ] }, "status": { "type": "string", "enum": [ "not-started", "in-progress", "complete", "failed" ] }, "text": { "type": "string", "minLength": 1 }, "textCompleted": { "type": "string", "minLength": 1 }, "userActions": { "type": "array", "items": { "type": "object", "properties": { "order": { "type": "integer", "minimum": 0 }, "key": { "type": "string", "pattern": "^[a-z0-9_.]+(-[a-z0-9_.]+)*$" }, "prompt": { "type": "string", "minLength": 1 }, "detail": { "type": "string", "minLength": 1 }, "label": { "type": "string", "minLength": 1 }, "url": { "oneOf": [ { "type": "string", "minLength": 0, "maxLength": 0 }, { "type": "string", "format": "uri", "pattern": "^https?:\\/\\/" } ] }, "disposition": { "type": "string", "enum": [ "document", "external", "fee", "modal" ] }, "mimeType": { "type": "string", "pattern": "^[^\\s/]+\\/[^\\s;]+(?:[ \\t]*;[^\\r\\n]*\\S)?$" }, "signers": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "signerType": { "type": "string", "enum": [ "concurrent" ] }, "qualifier": { "type": "string", "minLength": 1 }, "signers": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" } } }, "required": [ "signerType", "qualifier", "signers" ] }, { "type": "object", "properties": { "signerType": { "type": "string", "enum": [ "entity" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "type": { "type": "string", "minLength": 1, "maxLength": 255 }, "jurisdiction": { "type": "string", "minLength": 1, "maxLength": 255 }, "signers": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" } } }, "required": [ "signerType", "name", "signers" ] }, { "type": "object", "properties": { "signerType": { "type": "string", "enum": [ "individual" ] }, "role": { "type": "string", "minLength": 1, "nullable": true }, "firstName": { "type": "string", "minLength": 1 }, "middleName": { "type": "string", "minLength": 1, "nullable": true }, "lastName": { "type": "string", "minLength": 1 }, "fullName": { "type": "string", "minLength": 1 }, "email": { "oneOf": [ { "type": "string", "pattern": "^\\w+([-+.']\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$" }, { "type": "string" } ], "nullable": true }, "signers": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" } } }, "required": [ "signerType", "firstName", "lastName", "fullName" ] } ] } }, "amount": { "type": "string", "pattern": "^[0-9]+(\\.[0-9]+)?$" }, "currency": { "description": "Must be a valid Ethereum address, matching the RegEx pattern /^0x[a-fA-F0-9]{40}$/", "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "contractAuthorized": { "description": "Must be a valid Ethereum address, matching the RegEx pattern /^0x[a-fA-F0-9]{40}$/", "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "automateCollection": { "type": "boolean" } }, "required": [ "order", "key", "prompt", "label", "disposition" ] } }, "started": { "type": "string", "pattern": "^\\d{1,4}(-\\d{2}(-\\d{2}(T\\d{2}(:\\d{2}(:\\d{2}(\\.\\d{3,6})?)?)?)?(Z|([+-]\\d{2}(:\\d{2})?))?)?)?$", "nullable": true }, "expectedDurationSeconds": { "type": "integer", "minimum": 0, "nullable": true }, "expectedCompletion": { "type": "string", "pattern": "^\\d{1,4}(-\\d{2}(-\\d{2}(T\\d{2}(:\\d{2}(:\\d{2}(\\.\\d{3,6})?)?)?)?(Z|([+-]\\d{2}(:\\d{2})?))?)?)?$", "nullable": true }, "completed": { "type": "string", "pattern": "^\\d{1,4}(-\\d{2}(-\\d{2}(T\\d{2}(:\\d{2}(:\\d{2}(\\.\\d{3,6})?)?)?)?(Z|([+-]\\d{2}(:\\d{2})?))?)?)?$", "nullable": true }, "visibility": { "type": "boolean" } }, "required": [ "order", "key", "status", "text", "textCompleted", "started", "expectedDurationSeconds", "expectedCompletion", "completed", "visibility" ] } } }, "required": [ "order", "key", "status", "text", "textCompleted", "started", "expectedDurationSeconds", "expectedCompletion", "completed", "visibility" ] } } }, "required": [ "workflow", "createdAt", "updatedAt", "owners", "ownerType", "legalFirstName", "legalLastName", "legalFullName", "email", "steps" ] }, "WorkflowSignerDto": { "oneOf": [ { "type": "object", "properties": { "signerType": { "type": "string", "enum": [ "concurrent" ] }, "qualifier": { "type": "string", "minLength": 1 }, "signers": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" } } }, "required": [ "signerType", "qualifier", "signers" ] }, { "type": "object", "properties": { "signerType": { "type": "string", "enum": [ "entity" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "type": { "type": "string", "minLength": 1, "maxLength": 255 }, "jurisdiction": { "type": "string", "minLength": 1, "maxLength": 255 }, "signers": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" } } }, "required": [ "signerType", "name", "signers" ] }, { "type": "object", "properties": { "signerType": { "type": "string", "enum": [ "individual" ] }, "role": { "type": "string", "minLength": 1, "nullable": true }, "firstName": { "type": "string", "minLength": 1 }, "middleName": { "type": "string", "minLength": 1, "nullable": true }, "lastName": { "type": "string", "minLength": 1 }, "fullName": { "type": "string", "minLength": 1 }, "email": { "oneOf": [ { "type": "string", "pattern": "^\\w+([-+.']\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$" }, { "type": "string" } ], "nullable": true }, "signers": { "type": "array", "items": { "discriminator": { "propertyName": "signerType", "mapping": { "individual": "#/components/schemas/WorkflowIndividualSignerDto", "concurrent": "#/components/schemas/WorkflowConcurrentSignerDto", "entity": "#/components/schemas/WorkflowEntitySignerDto" } }, "$ref": "#/components/schemas/WorkflowSignerDto" } } }, "required": [ "signerType", "firstName", "lastName", "fullName" ] } ] } } } } ```