@@ -779,8 +779,11 @@ paths:
779779 /organizations :
780780 get :
781781 operationId : getOrganization
782- summary : Look up an organization by domain
783- description : Find a verified organization by its primary domain.
782+ summary : Look up an organization by domain or name
783+ description : >
784+ Provide domain, name, or both. When both are provided, the domain and
785+ name must belong to the same organization. If multiple organizations
786+ match, the most active one is returned.
784787 tags :
785788 - Organizations
786789 security :
@@ -789,12 +792,20 @@ paths:
789792 parameters :
790793 - name : domain
791794 in : query
792- required : true
795+ required : false
793796 description : Primary domain of the organization.
794797 schema :
795798 type : string
796799 minLength : 1
797800 example : linuxfoundation.org
801+ - name : name
802+ in : query
803+ required : false
804+ description : Exact display name of the organization.
805+ schema :
806+ type : string
807+ minLength : 1
808+ example : Linux Foundation
798809 responses :
799810 ' 200 ' :
800811 description : Organization found.
@@ -805,13 +816,14 @@ paths:
805816 example :
806817 id : 550e8400-e29b-41d4-a716-446655440000
807818 name : Linux Foundation
819+ domain : linuxfoundation.org
808820 logo : https://example.com/logo.png
809821 ' 401 ' :
810822 $ref : ' #/components/responses/Unauthorized'
811823 ' 403 ' :
812824 $ref : ' #/components/responses/Forbidden'
813825 ' 404 ' :
814- description : No verified organization found for the given domain.
826+ description : No organization found for the given domain or name .
815827 content :
816828 application/json :
817829 schema :
@@ -876,15 +888,26 @@ paths:
876888 required :
877889 - id
878890 - name
891+ - domain
879892 properties :
880893 id :
881894 type : string
882895 format : uuid
883896 name :
884897 type : string
898+ domain :
899+ type : string
900+ description : Verified primary domain of the organization.
901+ logo :
902+ type :
903+ - string
904+ - ' null'
905+ description : URL of the organization logo.
885906 example :
886907 id : 550e8400-e29b-41d4-a716-446655440000
887908 name : Acme Corp
909+ domain : acme.com
910+ logo : https://example.com/logo.png
888911 ' 400 ' :
889912 $ref : ' #/components/responses/BadRequest'
890913 ' 401 ' :
@@ -1218,6 +1241,7 @@ components:
12181241 - id
12191242 - organizationId
12201243 - organizationName
1244+ - organizationDomains
12211245 - jobTitle
12221246 - verified
12231247 - verifiedBy
@@ -1243,6 +1267,11 @@ components:
12431267 - string
12441268 - ' null'
12451269 description : URL of the organization logo.
1270+ organizationDomains :
1271+ type : array
1272+ items :
1273+ type : string
1274+ description : Verified primary domains for the organization, in alphabetical order.
12461275 jobTitle :
12471276 type :
12481277 - string
@@ -1531,13 +1560,17 @@ components:
15311560 required :
15321561 - id
15331562 - name
1563+ - domain
15341564 properties :
15351565 id :
15361566 type : string
15371567 format : uuid
15381568 name :
15391569 type : string
15401570 description : Display name of the organization.
1571+ domain :
1572+ type : string
1573+ description : Verified primary domain.
15411574 logo :
15421575 type : string
15431576 description : URL of the organization logo. Only present if available.
0 commit comments