Inventory

Table Overview

Name$raw FiltersDescription
location_schemaLists all location schemas
locationarchived$ column is not TrueLists all locations across location schemas
plate_schemaLists all plate schemas
platearchived$ column is not TrueLists all plates across plate schemas
box_schemaLists all box schemas
boxarchived$ column is not TrueLists all boxes across box schemas
container_schemaLists all container schemas
containerarchived$ column is not TrueLists all containers across container schemas
container_contentLists the combination of containers and the entities they're storing
container_transferLists all transfer actions from one container to another
sample_ownerLists all containers with sample owners designated
restricted_sample_partyLists all containers with restricted users designated

location_schema

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tablelocsch_LtEUFt89Primary key for a table
schema_typeSchema type selected for schema of objectTextlocation
nameName of object in BenchlingTextRoom, Chest Freezer, Shelf
system_nameName of warehouse table for this schemaTextroom, chest_freezer, shelf
archived$Archival state for object in BenchlingBooleantrue, falsetrue = object archived
archive_purpose$Archival reason for object in BenchlingTextMade in error, Retired, Expended, Shipped, Contaminated, Expired, Missing, Merged, OtherAvailable archive purpose options dependent on object
registry_idUnique identifier for an Organization's RegistryForeign Key for registry IDsrc_rdw6rOsL1 Registry per Organization
prefixPrefix selected for each schema objectTextRM, FRZ, SHLFPrefix will always come before Registry ID for registered objects

location

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tableloc_iybnCbxPPrimary key for a table
source_idThe project or registry that the object's permissions comes fromForeign key for project.id or registry IDsrc_hh9ffHqVIf an object isn't in a project, the permissions will be derived from the Registry
archived$Archival state for object in BenchlingBooleanfalse, true
archive_purpose$Archival reason for object in BenchlingTextMade in Error, Retired, Other, etcnull = object not archived
creator_idUnique identifier for creator of objectForeign key for user.ident_yXrL3BjX
created_atDate created for objectTimestamp without timezone2025-05-09T18:32:17.038287
modified_atDate object was modified in BenchlingTimestamp without timezone2025-05-09T18:32:17.038287
nameName of object in BenchlingCharacter Varying-80C Freezer, Main Lab, Bottom Shelf
schema_idUnique identifier for schema containing objectForeign key for schema.idlocsch_dTxFOOji
barcodeDisplays benchling barcode of the objectTextFRZ003, SHLF006
location_idUnique ID for location that contains objectForeign key for location.idloc_Y2v8daz0locations can be nested in other locations
total_capacityMaximum number of objects this location can containInteger40null = capacity has not been set
allows_non_location_childrenAllows plates, boxes, and containers to be stored in this locationBooleantrue, false
validation_statusValidation statusTextPASSED, FAILED
allowed_inventory_schema_idsList of schema types that can be stored in this locationJSONB[ "consch_A4Gnvi7Z", "consch_w7Ce8qra" ]null = schema restrictions have not been set

plate_schema

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tablepltsch_XIMFOcjiPrimary key for a table
schema_typeSchema type selected for schema of objectTextplate
nameName of object in BenchlingText96 Well
system_nameName of warehouse table for this schemaText_96_well
archived$Archival state for object in BenchlingBooleantrue, falsetrue = object archived
archive_purpose$Archival reason for object in BenchlingTextMade in error, Retired, Expended, Shipped, Contaminated, Expired, Missing, Merged, OtherAvailable archive purpose options dependent on object
registry_idUnique identifier for an Organization's RegistryForeign Key for registry IDsrc_rdw6rOsL1 Registry per Organization
prefixPrefix selected for each schema objectText96WPPrefix will always come before Registry ID for registered objects
plate_typePlate type for this schemaTextFIXED_PLATE, MATRIX_PLATE
heightNumber of plate rowsInteger8
widthNumber of plate columnsInteger12
container_schema_idUnique identifier for container schema used in plateTextconsch_qql2yvdu

plate

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tableplt_WodJ2D5NPrimary key for a table
source_idThe project or registry that the object's permissions comes fromForeign key for project.id or registry IDsrc_hh9ffHqVIf an object isn't in a project, the permissions will be derived from the Registry
archived$Archival state for object in BenchlingBooleanfalse, true
archive_purpose$Archival reason for object in BenchlingTextMade in Error, Retired, Other, etcnull = object not archived
creator_idUnique identifier for creator of objectForeign key for user.ident_yXrL3BjX
created_atDate created for objectTimestamp without timezone2025-05-09T18:32:17.038287
modified_atDate object was modified in BenchlingTimestamp without timezone2025-05-09T18:32:17.038287
nameName of object in BenchlingCharacter VaryingDilution Plate 12
schema_idUnique identifier for schema containing objectForeign key for schema.idpltsch_XIMFOcji
barcodeDisplays benchling barcode of the objectText96WP007
location_idUnique ID for location that contains objectForeign key for location.idloc_Y2v8daz0
urlurl for each object in BenchlingBrowser URLhttps://demo.benchling.com/#biotech-org/f/lib_J3tmt8BP-Entry%20Namet/etr_gRogHFOb-untitled/edit
total_capacityMaximum number of objects this plate can containInteger96null = fixed plate

box_schema

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tableboxsch_sjR9EMtoPrimary key for a table
schema_typeSchema type selected for schema of objectTextbox
nameName of object in BenchlingText10x10 Box
system_nameName of warehouse table for this schemaText_10x10_box
archived$Archival state for object in BenchlingBooleantrue, falsetrue = object archived
archive_purpose$Archival reason for object in BenchlingTextMade in error, Retired, Expended, Shipped, Contaminated, Expired, Missing, Merged, OtherAvailable archive purpose options dependent on object
registry_idUnique identifier for an Organization's RegistryForeign Key for registry IDsrc_rdw6rOsL1 Registry per Organization
prefixPrefix selected for each schema objectTextBOXPrefix will always come before Registry ID for registered objects
heightNumber of rows in boxInteger10
widthNumber of columns in boxInteger10
container_schema_idUnique identifier for container schema used in boxTextconsch_qql2yvdunull = schema restrictions have not been set

box

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tablebox_YF7MIqrgPrimary key for a table
source_idThe project or registry that the object's permissions comes fromForeign key for project.id or registry IDsrc_hh9ffHqVIf an object isn't in a project, the permissions will be derived from the Registry
archived$Archival state for object in BenchlingBooleanfalse, true
archive_purpose$Archival reason for object in BenchlingTextMade in Error, Retired, Other, etcnull = object not archived
creator_idUnique identifier for creator of objectForeign key for user.ident_yXrL3BjX
created_atDate created for objectTimestamp without timezone2025-05-09T18:32:17.038287
modified_atDate object was modified in BenchlingTimestamp without timezone2025-05-09T18:32:17.038287
nameName of object in BenchlingCharacter VaryingCell Line Box
schema_idUnique identifier for schema containing objectForeign key for schema.idboxsch_sjR9EMto
barcodeDisplays benchling barcode of the objectTextBOX007
location_idUnique ID for location that contains objectForeign key for location.idloc_Y2v8daz0
urlurl for each object in BenchlingBrowser URLhttps://demo.benchling.com/#biotech-org/f/lib_J3tmt8BP-Entry%20Namet/etr_gRogHFOb-untitled/edit
total_capacityMaximum number of objects this plate can containInteger100

container_schema

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tableconsch_A4Gnvi7ZPrimary key for a table
schema_typeSchema type selected for schema of objectTextcontainer
nameName of object in BenchlingTextCryovial
system_nameName of warehouse table for this schemaTextcryovial
archived$Archival state for object in BenchlingBooleantrue, falsetrue = object archived
archive_purpose$Archival reason for object in BenchlingTextMade in error, Retired, Expended, Shipped, Contaminated, Expired, Missing, Merged, OtherAvailable archive purpose options dependent on object
registry_idUnique identifier for an Organization's RegistryForeign Key for registry IDsrc_rdw6rOsL1 Registry per Organization
prefixPrefix selected for each schema objectTextCVPrefix will always come before Registry ID for registered objects

container

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tablecon_f49Iov6oPrimary key for a table
source_idThe project or registry that the object's permissions comes fromForeign key for project.id or registry IDsrc_hh9ffHqVIf an object isn't in a project, the permissions will be derived from the Registry
archived$Archival state for object in BenchlingBooleanfalse, true
archive_purpose$Archival reason for object in BenchlingTextMade in Error, Retired, Other, etcnull = object not archived
creator_idUnique identifier for creator of objectForeign key for user.ident_yXrL3BjX
created_atDate created for objectTimestamp without timezone2025-05-09T18:32:17.038287
modified_atDate object was modified in BenchlingTimestamp without timezone2025-05-09T18:32:17.038287
nameName of object in BenchlingCharacter VaryingReference Standard 3
schema_idUnique identifier for schema containing objectForeign key for schema.idconsch_A4Gnvi7Z
barcodeDisplays benchling barcode of the objectTextCV007
location_idUnique ID for location that contains objectForeign key for location.idloc_Y2v8daz0
urlurl for each object in BenchlingBrowser URLhttps://demo.benchling.com/#biotech-org/f/lib_J3tmt8BP-Entry%20Namet/etr_gRogHFOb-untitled/edit
box_idUnique ID for box that contains objectForeign key for box.idbox_YF7MIqrg
plate_idUnique ID for plate that contains objectForeign key for plate.idplt_WodJ2D5N
row_indexRow position where container is locatedInteger5, 7, 12, etcContainer must be in box
column_indexColumn position where container is locatedInteger5, 7, 12, etcContainer must be in box
volume_siVolume value for container content, in SI unitsDecimal0.005, 5e-06, etc.This is in SI units, not the original units created in the application
volume_display_unitsOriginal volume units for volume_si valueTextmL, uL, etc.For example, 5 mL will have 0.005 in the volume_si column and "mL" in the volume_display_units column
checkout_statusIndicates whether the container is checked-out, reserved, or availableTextAVAILABLE, RESERVED, CHECKED_OUT
checkout_status_modified_atThe date the container was last checked out, reserved, or checked intimestamp without timezone2025-05-09T18:32:17.038287
checkout_assignee_team_idUnique ID for the team the container is checked out or reserved forCharacter Varyingteam_oh5xGqrm, nullnull = checkout assignee is a user
checkout_assignee_user_idUnique ID for the user the container is checked out or reserved forCharacter Varyingent_naLWig4, nullnull = checkout assignee is a team
restriction_statusNOT_APPLICABLE for fixed plate wells and RESTRICTED or UNRESTRICTED for other containersCharacter VaryingRESTRICTED, UNRESTRICTED, NOT_APPLICABLE
primary_roleTextSAMPLE, STANDARD, CONTROL, BLANKonly applicable for containers in plates
subroleTextPOSITIVE, NEGATIVE, MINIMUM, MAXIMUMonly applicable for containers in plates
role_groupInteger1, 2, 3, etc.only applicable for containers in plates

container_content

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tablecontainer_batch_5292Primary key for a table
source_idThe project or registry that the object's permissions comes fromForeign key for project.id or registry IDsrc_hh9ffHqVIf an object isn't in a project, the permissions will be derived from the Registry
batch_idUnique identifier for batch objectForeign key for batch.idbat_Gs8PtV0KWhat batch is in the container
container_idUnique ID for container objectForeign key for container.idcon_gQMDFBm4
entity_idUnique identifier for entity objectForeign key for registry_entity.idbfi_cooUBrYbWhat entity is in the container
sample_aliquot_numberInteger1, 5, 12, etc.
concentration_siConcentration value for container content, in SI unitsDecimal6, 6.87, 7799499.2359, etcThis is in SI units, not the original units created in the application
concentration_display_unitsOriginal concentration units for concentration_si valueCharacter Varyingmg/mLFor example, 5 g / L will have 0.005 in the concentration_si column and "g / L" in the concentration_display_units column

container_transfer

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on table195340Primary key for a table
source_idThe project or registry that the object's permissions comes fromForeign key for project.id or registry IDsrc_hh9ffHqVIf an object isn't in a project, the permissions will be derived from the Registry
input_batch_idUnique ID for batch to be transferredForeign key for batch.idbat_Gs8PtV0KTransfer Table-related; not workflow related
input_container_idUnique ID for container that has entity/batch to be transferredForeign key for container.idcon_gQMDFBm4Transfer Table-related; not workflow related
input_entity_idUnique ID for entity to be transferredForeign key for registry_entity.idbfi_cooUBrYbTransfer Table-related; not workflow related
output_container_idUnique ID for newly created containerForeign key for container.idcon_r4gk3BEiTransfer Table-related; not workflow related
volume_siVolume value for container content, in SI unitsDecimal0.005, 5e-06, etc.This is in SI units, not the original units created in the application
volume_display_unitsOriginal volume units for volume_si valueTextmL, uL, etc.For example, 5 mL will have 0.005 in the volume_si column and "mL" in the volume_display_units column

sample_owner

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tablecon_lEQyR77W_ent_DtXwyMAqPrimary key for a table
container_idUnique ID for the container owned by this user/teamForeign key for container.idcon_lEQyR77W
user_idUnique ID for a user who is a sample owner for the containerForeign key for user.ident_DtXwyMAqnull = sample owner is a team
team_idUnique ID for a team that is a sample owner for the containerForeign key for team.idteam_i6p7XqWOnull = sample owner is a user

restricted_sample_party

Table RowDefinitionValue TypeExample values (if applicable)Notes
idUnique Benchling-prescribed ID for each line item in tableFormat dependent on tablecon_lEQyR77W_ent_DtXwyMAqPrimary key for a table
container_idUnique ID for the container restricted to this user/teamForeign key for container.idcon_lEQyR77W
user_idUnique ID for a user who is a sample user for the containerForeign key for user.ident_DtXwyMAqnull = sample user is a team
team_idUnique ID for a team that is a sample user for the containerForeign key for team.idteam_i6p7XqWOnull = sample user is a user

What’s Next