Skip to content
getgeolens.com
GeoLens DocsEarly release

Discover Tables

GET
/ingest/discover/
 
curl --request GET \
  --url 'https://example.com/api/ingest/discover/?limit=1000' \
  --header 'Authorization: Bearer <token>'

Discover unregistered tables in the data schema.

Returns tables not yet in the catalog, excluding staging, old, and system tables. Includes geometry type, SRID, and estimated row count. Bounded by limit (default 1000, max 5000) so instances with thousands of orphan tables don’t blow up the response payload.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
limit
Limit

Maximum number of tables to return (PERF-11 bound).

integer
default: 1000 >= 1 <= 5000

Maximum number of tables to return (PERF-11 bound).

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
DiscoverResponse
object
tables
required
Tables

Tables in the data schema that are eligible for registration as datasets.

Array<object>
DiscoveredTable
object
table_name
required
Table Name

PostgreSQL table name in the data schema.

string
geometry_type
required
Any of:
string
srid
required
Any of:
integer
estimated_rows
required
Any of:
integer
Example generated
{
  "tables": [
    {
      "table_name": "example",
      "geometry_type": "example",
      "srid": 1,
      "estimated_rows": 1
    }
  ]
}

400

Section titled “400 ”

Bad request — invalid payload

401

Section titled “401 ”

Unauthorized — missing or invalid credentials

403

Section titled “403 ”

Forbidden — caller lacks write access

404

Section titled “404 ”

Not found

409

Section titled “409 ”

Conflict — resource state prevents the operation

422

Section titled “422 ”

Validation error

500

Section titled “500 ”

Internal server error