---
title: "Retrieve a data project"
method: GET
path: "/projects/{owner}/{id}"
tags: ["projects"]
---

# Retrieve a data project

`GET /projects/{owner}/{id}`

Retrieve a project. The definition of the project will be returned, not the associated data. Use
`POST:/sql/{owner}/{id}` or `POST:/sparql/{owner}/{id}` to query the data or use dataset APIs to retrieve
data from linked datasets.

## Path parameters

- `owner` string, required
- `id` string, required

## Response `200`

default response

- ProjectSummaryResponse
  - `accessLevel` 'NONE, DISCOVER, READ, WRITE, ADMIN', required
  - `assetStatus` AssetStatus
    - `assetStatusLabel` string
    - `dispositionLabel` string
  - `created` string, date-time, required
  - `datasetStatistics` DatasetStatistics
    - `columnCount` integer
    - `fileCount` integer
    - `tableCount` integer
  - `dois` Doi[]
    - `created` string, date-time, required
    - `doi` string, required
  - `files` FileSummaryResponse[]
    - `created` string, date-time, required
    - `createdBy` string
    - `description` string
    - `labels` string[]
    - `name` string, required
    - `sizeInBytes` integer
    - `source` FileSourceSummaryResponse
      - `authorization` WebAuthorization
        - `credentials` string
        - `type` string, required
      - `credentials` WebCredentials
        - `password` string
        - `user` string, required
      - `dataTables` object
      - `databaseMetadataSpec` DatabaseMetadataSpecDto
        - `tableSpecs` TableMetadataSpecDto[]
          - `database` string
          - `schema` string
          - `tablePrefixes` string[]
          - `tableTypes` string[]
          - `tables` string[]
      - `databaseSource` DatabaseSourceReference
        - `id` string, uuid, required
        - `owner` string, required
      - `dwccSpec` DwccSpecDto
        - `databaseId` string
        - `metadataToExclude` string[]
        - `sourceDatabase` string
        - `sourceSchemas` string[]
        - `targetCatalog` string
      - `expandArchive` boolean
      - `lastSyncFailure` string, date-time
      - `lastSyncStart` string, date-time
      - `lastSyncSuccess` string, date-time
      - `mediaType` string
      - `mediaTypeLocked` boolean
      - `method` 'GET' | 'POST'
      - `oauthToken` OauthTokenReference
        - `id` string, uuid, required
        - `owner` string, required
        - `site` string, required
      - `requestEntity` string
      - `requestHeaders` object
      - `syncStatus` 'NEW' | 'INPROGRESS' | 'OK' | 'SYSTEMERROR', required
      - `syncSummary` string
      - `tableSpec` SingleTableMetadataSpecDto
        - `database` string
        - `schema` string
        - `table` string
        - `tableType` 'EXTRACT' | 'VIRTUAL'
      - `url` string, uri
      - `useDwCredentials` boolean
      - `viewRequest` ViewRequestDto
        - `baseAgentId` string, required
        - `baseDatasetId` string, required
        - `queryId` string, uuid
        - `queryName` string, required
        - `queryText` string
        - `queryType` 'SPARQL' | 'SQL', required
        - `runAsAgentId` string, required
        - `targetAgentId` string, required
        - `targetDatasetId` string, required
    - `updated` string, date-time, required
    - `updatedBy` string
  - `id` string, required
  - `license` 'Public Domain, PDDL, CC-0, CC-BY, CDLA-Permissive-1.0, CC-BY-IGO, CC-BY 3.0, CC-BY 3.0 AU, CC-BY 3.0 IGO, CC-BY-SA, CC-BY-SA 3.0, CDLA-Sharing-1.0, CC BY-NC, CC BY-ND, CC BY-ND 3.0, CC-BY 3.0 NZ, CC-BY-NC 3.0, CC BY-NC-ND, CC-BY-NC-SA 3.0, CC-BY-SA 3.0 NZ, CC-BY-NC-SA 3.0 NZ, CC-BY-NC 3.0 NZ, CC-BY-NC-ND-NZ-3.0, CC BY-NC-SA, Italian-ODL, MIT License, OGL, OGL-Canada, OGL-Nova Scotia, OGL-UK, OSODL, ODC-BY, ODC-ODbL, Other'
  - `linkedDatasets` LinkedDatasetSummaryResponse[]
    - `accessLevel` 'NONE, DISCOVER, READ, WRITE, ADMIN', required
    - `created` string, date-time, required
    - `description` string
    - `id` string, required
    - `license` 'Public Domain, PDDL, CC-0, CC-BY, CDLA-Permissive-1.0, CC-BY-IGO, CC-BY 3.0, CC-BY 3.0 AU, CC-BY 3.0 IGO, CC-BY-SA, CC-BY-SA 3.0, CDLA-Sharing-1.0, CC BY-NC, CC BY-ND, CC BY-ND 3.0, CC-BY 3.0 NZ, CC-BY-NC 3.0, CC BY-NC-ND, CC-BY-NC-SA 3.0, CC-BY-SA 3.0 NZ, CC-BY-NC-SA 3.0 NZ, CC-BY-NC 3.0 NZ, CC-BY-NC-ND-NZ-3.0, CC BY-NC-SA, Italian-ODL, MIT License, OGL, OGL-Canada, OGL-Nova Scotia, OGL-UK, OSODL, ODC-BY, ODC-ODbL, Other'
    - `owner` string, required
    - `summary` string
    - `tags` string[]
    - `title` string, required
    - `updated` string, date-time, required
    - `version` string
    - `visibility` 'OPEN, PRIVATE', required
  - `objective` string
  - `owner` string, required
  - `properties` object — All properties of the resource that are associated with a metadata presentation. Key is the IRI of the property. Value is the value of the property.
  - `similarResources` SimpleDataset[] — Similar projects with the same owner
    - `type` 'dataset' | 'project' — The type of the resource
    - `description` string
    - `id` string, required
    - `license` 'Public Domain, PDDL, CC-0, CC-BY, CDLA-Permissive-1.0, CC-BY-IGO, CC-BY 3.0, CC-BY 3.0 AU, CC-BY 3.0 IGO, CC-BY-SA, CC-BY-SA 3.0, CDLA-Sharing-1.0, CC BY-NC, CC BY-ND, CC BY-ND 3.0, CC-BY 3.0 NZ, CC-BY-NC 3.0, CC BY-NC-ND, CC-BY-NC-SA 3.0, CC-BY-SA 3.0 NZ, CC-BY-NC-SA 3.0 NZ, CC-BY-NC 3.0 NZ, CC-BY-NC-ND-NZ-3.0, CC BY-NC-SA, Italian-ODL, MIT License, OGL, OGL-Canada, OGL-Nova Scotia, OGL-UK, OSODL, ODC-BY, ODC-ODbL, Other'
    - `owner` string, required
    - `summary` string
    - `tags` string[]
    - `title` string
    - `visibility` 'OPEN, PRIVATE'
  - `status` 'NEW, INPROGRESS, LOADED, SYSTEMERROR', required
  - `summary` string
  - `tags` string[]
  - `title` string, required
  - `updated` string, date-time, required
  - `version` string, required
  - `versionDois` Doi[]
    - `created` string, date-time, required
    - `doi` string, required
  - `visibility` 'OPEN, PRIVATE', required

---

[API](https://skmtc.net/data/apis/data-world-public-api.md) · [All operations](https://skmtc.net/data/apis/data-world-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/data/data-world-public-api/versions/0a0cb1f94dad/schema)