Get features by ID

get

https://use.apilookup.for.a.base.url/layers/{layerId}/features

Returns all the features found for the provided list of IDs. The response is always a FeatureCollection, even if there are no features with the provided IDs.

Path Params

layerId

string

required

The unique identifier of the layer.

Query Params

array of strings

A comma separated list of unique feature identifiers. These are the acceptable formats for this field:

id=value1,value2
id=value1,id=value2

not required when eraseContent=true is used.

selection

array of strings

A list of properties to be returned in the features result list. Multiple attributes can be
specified by using comma(,).

Example: ?selection=p.name,p.capacity,p.color,rootpropertyname

!geometry : special value to omit geometries

selection

force2D

boolean

If set to true the features in the response have only X's and Y's as coordinates.

versionRef

string

Defaults to HEAD

The query parameter used to specify the target version reference when reading or writing features.
A reference describes a target tag or a version.

Default is: HEAD

Depending on the use-case it can be necessary to specify a range of versions rather than
only one version. In such a case the version part of the Ref would look like:
<start>..<end>

Where <start> is the start of the range (exclusive) and <end> is the end of the range
(inclusive).

Another way of specifying a version range is using the star-symbol: *

Using * refers to "all available versions" in the space or branch and is only
applicable in the cases in which a version range may be provided.

Samples:

42 points to version 42
HEAD points to the latest version
myTag points to the version of the tag with ID "myTag"
0..HEAD points to all available versions
* also points to all versions (short form)
5..10 points to the versions in the interval ]5, 10]

author

string

Filter the results per author.

Headers

string

enum

Defaults to application/geo+json

Generated from available response content types

Allowed:

Responses

200An array of features response.

401Unauthorized to perform the request.

403Forbidden request. Insufficient rights to perform the request.

404Not found.

513Response payload too large.