Skip to main content
Including its metadata, current status, and blockchain information.

Request

curl -X GET "https://api.g2cplatform.com/v2/objects/{objectId}" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Path Parameters

ParameterTypeRequiredDescription
objectIdstring (uuid)YesUnique identifier for the object

Response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "externalId": "LAPTOP-001",
  "name": "MacBook Pro 16-inch",
  "description": "Development laptop for engineering team",
  "summary": "High-performance laptop for software development",
  "owner": "John Doe",
  "status": "active",
  "categoryId": "cat_987fcdeb-51a2-43d8-9f0e-123456789abc",
  "subcategoryId": "sub_456def78-90ab-12cd-34ef-567890123456",
  "metadata": {
    "serialNumber": "C02XK1F2JGH7",
    "purchaseDate": "2024-01-15",
    "warranty": "3 years"
  },
  "createdAt": "2024-03-15T10:30:00Z",
  "updatedAt": "2024-03-15T15:45:00Z",
  "blockchain": {
    "txId": "abc123...def456",
    "lastTxId": "ghi789...jkl012",
    "eventCount": 5
  }
}

Response Fields

FieldTypeDescription
idstringUnique identifier for the object
externalIdstringUser-defined external identifier
namestringObject name
descriptionstringDetailed description
summarystringBrief summary
ownerstringCurrent owner
statusstringObject status (active, inactive, stolen, transferred, archived)
categoryIdstringParent category ID
subcategoryIdstringParent subcategory ID
metadataobjectAdditional metadata as key-value pairs
createdAtstringISO 8601 timestamp when object was created
updatedAtstringISO 8601 timestamp when object was last updated
blockchainobjectBlockchain-related information

Error Responses

Status CodeDescription
401Unauthorized - invalid API key
404Object not found
500Internal server error

Usage Notes

  • Objects contain complete metadata and blockchain audit trail information
  • The blockchain field includes transaction IDs and event count for verification
  • Use the externalId for business logic and the id for API operations
  • All object changes are tracked with immutable blockchain records