Attention: This site does not support the current version of your web browser. To get the best possible experience using our website we recommend that you upgrade to a newer version or install another browser

Source Descriptions


The Source Descriptions resource adds a source description to the contributor's set of source descriptions.

The FamilySearch implementation of the Source Description resource does not support all properties of a source description as defined by GEDCOM X. For more information, see the Source Description Resource.

User-Uploaded Sources

To create a user-uploaded source, create a source description that describes a memory resource.

Data Formats


If you make a GET request, specify the desired data format using the Accept header.


If you POST something, specify the data format using the Content-Type header.


Name Type Description
Authorization header The authorization carrying the OAuth 2.0 access token. See OAuth 2.0 Bearer Tokens.
access_token query The ID of the OAuth 2 access token used for identification and authorization of the user (and agent) making the request.
sdids query A comma and/or space separated list of source description ids.


GET - Read the list of all user-defined source descriptions. This method is not currently available and requests will be denied access.

Status Codes
303 Upon a successful read; redirecting to the current user's list of all sources.


Status Codes
201 The creation of the source description was successful. Expect a location header specifying the link to the created source description.
400 If the request was unable to be understood by the application.
400 Blacklisted URI: The URI is blacklisted
400 Uncategorized URI: The URI is not categorized
400 Invalid URI: The URI is invalid

Example Requests

Create Source Description How to create a source description.
Create User-Uploaded Source How to create a source for an artifact that a user has uploaded.

Select a language