Currently, there's no way to obtain the documents foreign swatches, objects or colors. So not even the name of a color used in the document can be used. Please expose all attributes of the documents JSON via API, as this is crucial for any plugin development or batch scripting.