This API returns a paginated list of tables contained within a specific schema. Each table represents a Delta Lake table or view.
Request {prefix}/shares/{share}/schemas/{schema}/tables
Bearer token for authentication Authorization: Bearer {token}
URL Parameters The share name to query. This parameter is case-insensitive.
The schema name to query. This parameter is case-insensitive.
Query Parameters The maximum number of results per page that should be returned.
Must be non-negative
0 will return no results but nextPageToken may be populated
Server may return fewer items even if more are available
Specifies a page token to use. Set to the nextPageToken returned by a previous list request to get the next page of results.
Response Array of table objects. May be an empty array or missing when no results are found. Table name (case-insensitive). Must not exceed 255 characters.
The parent schema name. Must not exceed 255 characters.
The parent share name. Must not exceed 255 characters.
Unique identifier for the parent share. Should be immutable through the share’s lifecycle.
Unique identifier for the table within the share. Should be immutable through the table’s lifecycle. Format recommendation: UUID.
Root directory of the table where the delta log exists. Required if the server supports directory-based access (dir in accessModes).
Optional array of extra storage locations for table files. Usually no more than one location. Required for tables with files stored outside the root directory.
Supported access modes for the table. Can include:
url: Server supports URL-based access via QueryTable APIdir: Server supports directory-based access via GenerateTemporaryTableCredential API If not present, client assumes only URL-based access is supported. Token for retrieving the next page of results. May be an empty string or missing when there are no additional results.
Example Request curl -X GET \ '{prefix}/shares/vaccine_share/schemas/acme_vaccine_data/tables?maxResults=10' \ -H 'Authorization: Bearer {token}'
Example Response { "items" : [ { "share" : "vaccine_share" , "schema" : "acme_vaccine_data" , "name" : "vaccine_ingredients" , "shareId" : "edacc4a7-6600-4fbb-85f3-a62a5ce6761f" , "id" : "dcb1e680-7da4-4041-9be8-88aff508d001" }, { "share" : "vaccine_share" , "schema" : "acme_vaccine_data" , "name" : "vaccine_patients" , "shareId" : "edacc4a7-6600-4fbb-85f3-a62a5ce6761f" , "id" : "c48f3e19-2c29-4ea3-b6f7-3899e53338fa" } ], "nextPageToken" : "..." }
Error Responses The request is malformed. { "errorCode" : "string" , "message" : "string" }
The bearer token is missing or incorrect. { "errorCode" : "string" , "message" : "string" }
The request is forbidden from being fulfilled. { "errorCode" : "string" , "message" : "string" }
The requested resource does not exist. { "errorCode" : "string" , "message" : "string" }
Show 500 - Internal Server Error
The request is not handled correctly due to a server error. { "errorCode" : "string" , "message" : "string" }
Access Modes The accessModes field indicates how clients can access table data:
URL-based access (url): Server returns pre-signed URLs for individual filesDirectory-based access (dir): Server issues temporary cloud credentials for direct storage access If accessModes is not present, assume URL-based access only. 