---
title: "Returns the details of the synchronization for the provided data source."
method: GET
path: "/synchronizations/byDataSource"
tags: ["Synchronizations"]
---

# Returns the details of the synchronization for the provided data source.

`GET /synchronizations/byDataSource`

## Query parameters

- `dataSource` string, required

## Response `200`

The set of data access rules to synchronize

- Synchronization — All information needed to perform synchronization
  - `id` string — Operation id
  - `dataAccessRuleSet` DataAccessRuleSet — All of the data access rules that need to be synchronized.
    - `databases` Database[], required
      - `provider` string, required — Value must be "Snowflake", "GoogleBigQuery, or "AWSLakeFormation"
      - `providerDetails` ProviderDetails — The provider specific details. For example, AWSLakeFormation contains the property awsRegion, which denotes in which region the database is located.
      - `id` string, required — The id of the database
      - `name` string, required — The name of the database
      - `schemas` DatabaseSchema[]
        - `id` string, required — The id of the database schema
        - `name` string, required — The name of the database schema
        - `tables` DatabaseTable[], required
          - `id` string, required — The id of the database table
          - `name` string, required — The name of the database table
          - `columns` DatabaseColumn[], required
            - `id` string, required — The id of the database column
            - `name` string, required — The name of the database column
            - `dataType` string — The data type as it is declared by the provider. For example: String, Integer, Varchar, Blob, Boolean, ...
            - `precision` integer — The precision of the column.
            - `scale` integer — The scale of the column.
            - `tags` DatabaseColumnTag[], required
              - …
            - `accesses` DatabaseColumnAccessRule[], required
              - …
          - `accesses` DatabaseTableAccessRule[], required
            - `group` string, required — The name of protect group
            - `access` string, required — Possible values are: `Read` or `NoChange`.
      - `tags` DatabaseTag[], required
        - `id` string, required — The id of database tag
        - `name` string — The name of database tag
        - `maskings` GroupMasking[], required
          - `group` string, required — The name of protect group
          - `masking` union, required
            - NoMasking
              - …
            - DefaultMasking
              - …
            - ConstantMasking — This masked strategy is not supported by the Protect application therefore it is deprecated and it will be removed in new versions of the API. Use DefaultMasking instead.
              - …
            - HashMasking
              - …
            - ShowLastMasking
              - …
            - CustomMasking
              - …
      - `customMaskings` DatabaseCustomMasking[], required
        - `id` string, uuid — The id of database custom masking
        - `name` string — The name of database custom masking
        - `mappings` MaskingMappings[]
          - `dataType` string, required — The name of the data type (String, Number, Date ...). Data types name depend on the provider, a list of compatible types per provider is available in the documentation.
          - `functionName` string, required — The name of the function that will be used on the provider to provide the custom masking.

## Other responses

- `400` — The request is not valid.
- `401` — The client is not authenticated.
- `403` — The user lacks permissions.
- `404` — Resource not found.
- `500` — There was an error processing the request.

---

[API](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api.md) · [All operations](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collibra/collibra-data-governance-center-core-api/revisions/6d091bc86a33/schema)