Thanks - in our case though we would not have organizations setup/defined for each of our providers. The functionality that you describe is the ability to lookup an agreement based on it's organization (as defined in organizations module) – is my understanding correct? Or is there a way to set this up without having an organization defined in the organization module (mod-vendor/mod-organization)? Could the sourceUri for the org be a reference to an ekb provider record? Sample requests on how to do this would be helpful

I'm free-forming as I don't have a console in front of me —

filters=orgs.org.reference%3D%REFERENCE

will query by reference. Fuller explanation - the whole domain model is exposed to the filter endpoint. If you go to the domain class definition, eg - go to

https://github.com/folio-org/mod-agreements/blob/master/service/grails-app/domain/org/olf/erm/SubscriptionAgreement.groovy

And you will see a hasMany orgs:SubscriptionAgreementOrg (currently around line 86) this tells you that a SubscriptionAgreement has many SubscriptionAgreementOrgs and the colleciton is called orgs - so the first part of your filter path is orgs.

Look up subscriptionAgreementOrg and you'll see it has 2 properties - the subscripton agreement and and Org property named "org" - So the next part of the path is ".org" - So far "orgs.org". Look up Org and you'll see there is a string property called reference... Giving us "orgs.org.reference"

https://github.com/folio-org/mod-agreements/blob/master/service/grails-app/domain/org/olf/general/Org.groovy

Of course the Org has to have been created using { reference:'REF-YOU-WANT-TO-Use' } - And this might get tricky once we have multiple KB vendors all wanting us to track the reference they use for provider. At that point, we will need to add the full namespaced identifier functionality to Org (Tho this will eventually belong on the refactored Vendors app anyway) .

Makes sense?

cg - 03/15/2019 – This ticket is blocked as eHoldings currently does not have a way to make a request to Agreements application to find all agreements that have been linked to a specific Provider Id.

Below ticket shows investigation of Agreements method calls to that are available
https://folio-org.atlassian.net/browse/MODKBEKBJ-151

We can associate packages or title+package to an agreement (indicating reference with unique id - such as the following)

We can look up agreements associated with the above referenced package (such as below)

As noted, we do not have a method to lookup agreements by provider id. (ie get any agreements tied to packages or title+packages for that provider).

One potential solution would be to supply Provider Id when associating a package or title+package to an agreement.